EL4CTEO/roblox-devforum-mcp 预览 preview

EL4CTEO/roblox-devforum-mcp

Give your AI coding agent the Roblox DevForum and official creator docs — check if a bug is already known, read the accepted answer, and verify APIs before writing Luau.

Project Overview项目介绍

roblox-devforum-mcp is a DSH MCP server plugin that lets an AI coding agent query the Roblox Developer Forum and official creator docs, with no API key or login. It exposes read-only tools for searching threads, checking bug status with Roblox's tag, reading accepted answers, and verifying Luau API health. Use it when a script error looks platform-side or when an API may be deprecated. Data is pulled from public Discourse and GitHub sources, is not affiliated with Roblox Corporation, and links should be re-checked for currency.

roblox-devforum-mcp 是一个面向 DSH 的 MCP 服务器插件,让 AI 编码代理直接查询 Roblox 开发者论坛与官方创作文档,无密钥免登录。核心能力包括搜索帖子、检索 Bug 状态、读取话题、核对 Luau API 健康度等十余个只读工具。当 Luau 脚本遇到疑似平台端错误、API 弃用或文档歧义时即可调用。需注意数据来源为公开 Discourse 与 GitHub 仓库,不附属于 Roblox 公司,引用前应核实时效。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

EL4CTEO/roblox-devforum-mcp 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

Roblox Developer Forum

roblox-devforum-mcp

An MCP server that gives an AI coding agent the Roblox Developer Forum and the official creator docs.

When your agent hits a Roblox bug, it can check whether Roblox already has it triaged, read the accepted answer, and confirm the API before writing Luau.

No API key, no login, no setup.

Install

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

DeepSeek Harness:

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

Any other MCP client:

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

Tools

Tool What it does
search_devforum Search the forum. Filters for category, tag, solved-only, likes and date. Pass several phrasings to run them at once.
search_bugs Search only the bug-report categories, so a hit means somebody reported the same symptom.
get_thread Read a topic as Markdown, accepted answer first, code blocks intact.
get_replies Page through a long thread.
list_recent Latest or top topics in a category or tag.
list_categories Every category and tag slug the filters accept.
search_creator_docs Search the docs by page content; pass path to read a page in full.
get_engine_api Signatures, security levels and deprecations from the live API dump.
check_api_health Check APIs before you ship: removed, deprecated, security-gated, yielding.
get_whats_new Recent platform changes — for "this worked last week".
get_weekly_recap Any Roblox Weekly Recap, current or historical.

Every tool is read-only, returns Markdown with source URLs, and stays inside a token budget.

[answered] beside a result means a reply was marked as the solution — by whoever opened the thread, not by Roblox. Roblox does not publish a triage state, so read the thread to see whether staff replied.

Example

"My DataStore:SetAsync keeps failing with 502: API Services rejected request. Is this on Roblox's end?"

The agent runs search_bugs on the error text, get_thread on the best hit, then check_api_health before touching your code.

Configuration

All optional.

Variable Default Purpose
DEVFORUM_CACHE_TTL 300 Search cache lifetime, in seconds.
DEVFORUM_TIMEOUT_MS 12000 Per-request timeout.
DEVFORUM_DEADLINE_MS 24000 Total time one request may spend, retries included.
DEVFORUM_MAX_RETRIES 3 Retries on 429 and 5xx.
DEVFORUM_CONCURRENCY 4 Simultaneous requests to the DevForum.
DEVFORUM_CDN_CONCURRENCY 8 Simultaneous requests to GitHub-hosted docs.
DEVFORUM_DOCS_SCAN 14 Doc pages scored per search.
DEVFORUM_CACHE_DIR OS temp dir Where the API dump and docs index are cached.
DEVFORUM_BASE_URL https://devforum.roblox.com Point at another Discourse instance.

A bad value is ignored, with a note on stderr, and the default is used.

Data sources

devforum.roblox.com (public Discourse API), Roblox/creator-docs, and the Roblox-Client-Tracker API dump.

Not affiliated with or endorsed by Roblox Corporation.

Development

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

License

MIT

上一个 Prev muretai-dsh-skill 下一个 Next dsh-remote-development