roblox-devforum-mcp

roblox-devforum-mcp

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

Quando seu agente encontra um bug na Roblox, ele pode verificar se a Roblox já classificou o problema, 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

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 resolvidos, curtidas e data. Envie várias frases para executá-las de uma vez.
search_bugs	Pesquisa apenas relatórios de bugs e mostra a tag de status da Roblox: confirmado, corrigido, não reproduzível.
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 principais em uma categoria ou tag.
list_categories	Todas as categorias e slugs de 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 por completo.
get_engine_api	Assinaturas, níveis de segurança e depreciações do dump de API ao vivo.
check_api_health	Verifique APIs antes de publicar: removidas, obsoletas, 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 resumo semanal da Roblox, atual ou histórico.

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

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, em seguida, 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_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 de 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.
GITHUB_TOKEN	—	Aumenta o limite de taxa do GitHub para a listagem de arquivos da documentação.

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 de 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