roblox-devforum-mcp

Dê ao seu agente de codificação de IA o DevForum da Roblox e a documentação oficial para criadores — verifique se um bug já é conhecido, leia a resposta aceita e valide APIs antes de escrever Luau.

GitHub

Documentação

roblox-devforum-mcp

Um servidor MCP que dá a um agente de codificação de IA o Fórum de Desenvolvedores Roblox e a documentação oficial para criadores.

Quando seu agente encontra um bug no Roblox, ele pode verificar se a Roblox já fez a triagem, ler a resposta aceita e confirmar a API antes de escrever Luau.

Sem chave de API, sem login, sem configuração.

Instalação

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

DeepSeek Harness:

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

Qualquer outro cliente MCP:

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

Ferramentas

Ferramenta	O que faz
`search_devforum`	Pesquisa no fórum. Filtros por categoria, tag, apenas solucionados, curtidas e data. Passe várias frases para executá-las de uma vez.
`search_bugs`	Pesquisa apenas nas categorias de relatório de bugs, então um resultado significa que alguém relatou o mesmo sintoma.
`get_thread`	Lê um tópico como Markdown, resposta aceita primeiro, blocos de código intactos.
`get_replies`	Navega por uma thread longa.
`list_recent`	Tópicos mais recentes ou mais populares em uma categoria ou tag.
`list_categories`	Todos os slugs de categorias e tags que os filtros aceitam.
`search_creator_docs`	Pesquisa na documentação pelo conteúdo da página; passe `path` para ler uma página completa.
`get_engine_api`	Assinaturas, níveis de segurança e depreciações para classes, enums, datatypes e bibliotecas Luau.
`check_api_health`	Verifique APIs antes de publicar: removidas, depreciadas, maiúsculas/minúsculas incorretas, com restrição de segurança, com yield.
`get_whats_new`	Mudanças recentes na plataforma — para "isso funcionava na semana passada".
`get_weekly_recap`	Qualquer Roblox Weekly Recap, atual ou histórico.

Toda ferramenta é somente leitura, retorna Markdown com URLs de origem e permanece dentro de um orçamento de tokens.

[answered] ao lado de um resultado significa que uma resposta foi marcada como a solução — por quem abriu a thread, não pela Roblox. A Roblox não publica um estado de triagem, então leia a thread para ver se a equipe respondeu.

Exemplo

"Meu DataStore:SetAsync continua falhando com 502: API Services rejected request. Isso é um problema do lado da Roblox?"

O agente executa search_bugs no texto do erro, get_thread no melhor resultado, e então check_api_health antes de tocar no seu código.

Configuração

Tudo opcional.

Variável	Padrão	Finalidade
`DEVFORUM_CACHE_TTL`	`300`	Tempo de vida do cache de pesquisa, em segundos.
`DEVFORUM_TIMEOUT_MS`	`12000`	Timeout por requisição.
`DEVFORUM_DEADLINE_MS`	`24000`	Tempo total que uma requisição pode gastar, incluindo tentativas.
`DEVFORUM_MAX_RETRIES`	`3`	Tentativas em 429 e 5xx.
`DEVFORUM_CONCURRENCY`	`4`	Requisições simultâneas ao DevForum.
`DEVFORUM_CDN_CONCURRENCY`	`8`	Requisições simultâneas à documentação hospedada no GitHub.
`DEVFORUM_DOCS_SCAN`	`14`	Páginas de documentação pontuadas por pesquisa.
`DEVFORUM_CACHE_DIR`	Diretório temporário do SO	Onde o dump da API e o índice da documentação são armazenados em cache.
`DEVFORUM_BASE_URL`	`https://devforum.roblox.com`	Aponte para outra instância do Discourse.

Um valor inválido é ignorado, com uma nota no stderr, e o padrão é usado.

Fontes de dados

devforum.roblox.com (API pública do Discourse), Roblox/creator-docs e o Roblox-Client-Tracker dump da API.

Não afiliado ou endossado pela Roblox Corporation.

Desenvolvimento

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

Licença

MIT