Roblox 开发论坛助手 EL4CTEO/roblox-devforum-mcp

roblox-devforum-mcp

一个 MCP 服务器，让 AI 编程智能体用上 Roblox Developer Forum 和官方创作者文档。

智能体遇到 Roblox 的 bug 时，可以先查 Roblox 是否已经分诊过，读一下采纳的答案，写 Luau 之前再确认一遍 API。

不用 API key，不用登录，不用配置。

安装

claude mcp add roblox-devforum -- npx -y roblox-devforum-mcp

DeepSeek Harness：

dsh plugin --profile web add roblox-devforum-mcp

其他 MCP 客户端：

{
"mcpServers": {
"roblox-devforum": {
"command": "npx",
"args": ["-y", "roblox-devforum-mcp"]
}
}
}

工具

| 工具 | 作用 |
| search_devforum | 搜索论坛。可按分类、标签、仅已解决、点赞数和日期过滤。传入多种说法，一次并行搜完。 |
| search_bugs | 只搜 bug 报告分类，命中就说明有人报过同样的症状。 |
| get_thread | 以 Markdown 读取主题，采纳答案排在最前，代码块原样保留。 |
| get_replies | 分页读取长主题。 |
| list_recent | 按分类或标签列出最新或最热主题。 |
| list_categories | 列出过滤器支持的所有分类和标签 slug。 |
| search_creator_docs | 按页面内容搜索文档；传入 path（或文档 URL）可读取整页。 |
| get_engine_api | 查询类、枚举、数据类型和 Luau 库的签名、安全级别与弃用信息。 |
| check_api_health | 上线前检查 API：已移除、已弃用、大小写错误、受安全级别限制、会让出线程。 |
| get_whats_new | 最近的平台变更——专治「上周还能用」。 |
| get_weekly_recap | 任意一期 Roblox Weekly Recap，当前或历史。 |

所有工具都是只读的，返回带来源 URL 的 Markdown，并控制在 token 预算内。

结果旁的 [answered] 表示有回复被标为解决方案——标记的人是发帖者，不是 Roblox。Roblox 不公开分诊状态，所以要看官方是否回复，得自己读主题。

示例

「我的 DataStore:SetAsync 一直失败，报 502: API Services rejected request。这是 Roblox 那边的问题吗？」

智能体会用错误文本跑 search_bugs，对最匹配的结果跑 get_thread，动你的代码之前再跑 check_api_health。

配置

全部可选。

| 变量 | 默认值 | 用途 |
| DEVFORUM_CACHE_TTL | 300 | 搜索缓存有效期，单位秒。 |
| DEVFORUM_TIMEOUT_MS | 12000 | 单次请求超时。 |
| DEVFORUM_DEADLINE_MS | 24000 | 单次请求可用的总时长，含重试。 |
| DEVFORUM_MAX_RETRIES | 3 | 遇到 429 和 5xx 时的重试次数。 |
| DEVFORUM_CONCURRENCY | 4 | 同时发往 DevForum 的请求数。 |
| DEVFORUM_CDN_CONCURRENCY | 8 | 同时向 GitHub 托管的文档发起的请求数。 |
| DEVFORUM_DOCS_SCAN | 14 | 每次搜索评分的文档页数。 |
| DEVFORUM_CACHE_DIR | 系统临时目录 | API dump 和文档索引的缓存位置。 |
| DEVFORUM_BASE_URL | https://devforum.roblox.com | 指向另一个 Discourse 实例。 |

值不合法时会被忽略，并在 stderr 上留一条提示，改用默认值。

数据来源

devforum.roblox.com（公开 Discourse API）、 Roblox/creator-docs，以及 Roblox-Client-Tracker 的 API dump。

与 Roblox Corporation 无关联，也未获其认可。

开发

npm install && npm run build
npm test # offline unit and server tests
npm run inspect # MCP Inspector against the built server

许可证

MIT