游戏引擎API参考与资源管理

为S&box游戏引擎提供API参考、Wiki文档和Workshop资源管理的服务,包含1800+类型、15000+成员、8000+文档条目、200+Wiki页面及社区资源。

  • by SofianeBel
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 SofianeBel/sbox-api-mcp

使用说明

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-mcp

npx(直接)

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会发生更改。您可以通过两种方式进行更新:

  1. 来自克劳德代码: 使用 update_api_source 使用新URL的工具
  2. 环境变量: 集 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服务以获取社区制造的资产。

许可证

麻省理工学院