sbox api mcp
MCP服务器 S&盒子 游戏引擎-API参考资料、wiki文档和Workshop资产。索引 1800多种类型, 15000+会员，以及 8000多个文件条目 来自标准箱API，以及 200多个wiki页面 （指南、教程、概念）和社区研讨会资源，所有这些都可以直接从Claude Code中搜索。
安装
Claude代码插件（推荐）
claude plugin add sofianebel/sbox-api-mcp手动MCP设置
claude mcp add sbox-api -- npx -y sbox-api-mcpnpx（直接）
npx sbox-api-mcp工具
| 工具 | 说明 | 示例 |
|---|---|---|
| API 参考 | ||
search_types | 模糊搜索类型（类、结构、枚举、接口） | search_types({ query: "GameObject" }) |
get_type | 特定类型（方法、属性、字段）的完整详细信息 | get_type({ name: "Sandbox.GameObject" }) |
search_members | 跨所有类型的搜索方法/属性 | search_members({ query: "Position", kind: "property" }) |
list_namespaces | 列出所有具有类型计数的API命名空间 | list_namespaces({ filter: "Audio" }) |
search_docs | 文档摘要中的全文搜索 | search_docs({ query: "play sound" }) |
update_api_source | 当S&box发布新版本时更新API数据URL | update_api_source({ url: "https://cdn.sbox.game/releases/..." }) |
| Wiki文档 | ||
search_wiki | 搜索s和box wiki页面（指南、教程、概念） | search_wiki({ query: "networking" }) |
get_wiki_page | 通过markdown获取wiki页面的完整内容 | get_wiki_page({ path: "scene/components" }) |
| 工作坊（教资会） | ||
search_packages | 搜索社区研讨会资源（模型、声音、地图等） | search_packages({ query: "zombie" }) |
get_package | 获取特定工作坊套餐的详细信息 | get_package({ ident: "facepunch.zombiemale" }) |
配置
环境变量（可选）：
| 变量 | 描述 | 默认值 |
|---|---|---|
SBOX_API_URL | 覆盖S&box API JSON URL | 已知的最新版本 |
SBOX_CACHE_DIR | 覆盖缓存目录 | ~/.sbox-api-mcp/ |
更新API数据
当S&box发布新版本时，API JSON URL会发生更改。您可以通过两种方式进行更新：
- 来自克劳德代码： 使用
update_api_source使用新URL的工具 - 环境变量： 集
SBOX_API_URL到新URL
URL格式为： https://cdn.sbox.game/releases/YYYY-MM-DD-HH-MM-SS.zip.json
运作原理
API参考： 在第一次启动时，服务器下载S&box API JSON（~9MB），并将其缓存在本地 ~/.sbox-api-mcp/。如果数据没有变化，后续的初创公司会使用ETag检查跳过重新下载。API数据在内存中使用 Fuse.js 用于跨类型名、成员名和文档摘要进行快速模糊搜索。
Wiki文档： 利用S&box的LLM优化端点(llms.txt 指数+ .md 原始降价页面）。wiki索引在首次使用时获取，并在内存中缓存1小时。单个页面从以下位置实时获取 sbox.game/dev/doc/ 作为原始降价。
工作坊（UGC）： 查询API直播的Facepunch服务以获取社区制造的资产。
许可证
麻省理工学院