roblox-devforum-mcp

为你的AI编程代理提供Roblox开发者论坛和官方创作者文档——检查已知Bug、阅读采纳答案，并在编写Luau代码前验证API。

文档

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. A small native binary (Rust): starts instantly, uses ~6 MB of RAM.

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"]
    }
  }
}

No Node.js? Download the binary for your system from the latest release, or build it with cargo install --git https://github.com/EL4CTEO/roblox-devforum-mcp, then use it directly:

claude mcp add roblox-devforum -- /path/to/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` (or a docs URL) to read a page in full.
`get_engine_api`	Signatures, security levels and deprecations for classes, enums, datatypes and Luau libraries.
`check_api_health`	Check APIs before you ship: removed, deprecated, wrong case, 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.
`ROBLOX_DEVFORUM_MCP_BINARY`	—	npm only: run this binary instead of the bundled one.

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

Needs Rust 1.99+.

cargo build --release   # target/release/roblox-devforum-mcp
cargo test              # offline unit and tool tests
npm run inspect         # MCP Inspector against the release build

Releases: push a vX.Y.Z tag and CI builds every binary, publishes to npm and attaches the binaries to the GitHub release. See CHANGELOG.md.

License

MIT