EL4CTEO/roblox-devforum-mcp

roblox-devforum-mcp

一个 MCP 服务器，让 AI 编程智能体能够访问 Roblox
开发者论坛 和 官方创作者文档。

当你的智能体遇到 Roblox bug 时，它可以检查 Roblox 是否已经对该问题进行了分类处理，阅读
已采纳的答案，并在编写 Luau 代码之前确认 API。

无需 API 密钥，无需登录，无需配置。

安装

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 可阅读完整页面。 |
| get_engine_api | 来自实时 API 转储的签名、安全级别和弃用信息。 |
| check_api_health | 在发布前检查 API：已移除、已弃用、受安全限制、会让出线程。 |
| get_whats_new | 最近的平台变更——用于排查“上周还能用”。 |
| get_weekly_recap | 任意一期 Roblox 每周回顾，当前或历史版本。 |

每个工具都是只读的，返回带来源 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 转储和文档索引的缓存位置。 |
| DEVFORUM_BASE_URL | https://devforum.roblox.com | 指向另一个 Discourse 实例。 |

错误的值会被忽略，并在 stderr 上给出提示，然后使用默认值。

数据来源

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

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

开发

npm install && npm run build
npm test          # 离线单元测试和服务器测试
npm run inspect   # 针对已构建服务器的 MCP Inspector

许可证

MIT