roblox-devforum-mcp
Dale a tu agente de codificación de IA el DevForum de Roblox y los documentos oficiales para creadores: verifica si un error ya es conocido, lee la respuesta aceptada y confirma las APIs antes de escribir Luau.
Documentación
roblox-devforum-mcp
Un servidor MCP que le brinda a un agente de codificación de IA el Foro de Desarrolladores de Roblox y la documentación oficial para creadores.
Cuando tu agente encuentra un error de Roblox, puede verificar si Roblox ya lo tiene clasificado, leer la respuesta aceptada y confirmar la API antes de escribir Luau.
Sin clave de API, sin inicio de sesión, sin configuración.
Instalación
claude mcp add roblox-devforum -- npx -y roblox-devforum-mcp
Cualquier otro cliente MCP:
{
"mcpServers": {
"roblox-devforum": {
"command": "npx",
"args": ["-y", "roblox-devforum-mcp"]
}
}
}
Herramientas
| Herramienta | Qué hace |
|---|---|
search_devforum | Busca en el foro. Filtros por categoría, etiqueta, solo resueltos, me gusta y fecha. Pasa varias frases para ejecutarlas a la vez. |
search_bugs | Busca solo en los informes de errores y muestra la etiqueta de estado de Roblox: confirmado, corregido, no reproducible. |
get_thread | Lee un tema como Markdown, respuesta aceptada primero, bloques de código intactos. |
get_replies | Recorre un hilo largo por páginas. |
list_recent | Temas más recientes o más populares en una categoría o etiqueta. |
list_categories | Cada slug de categoría y etiqueta que aceptan los filtros. |
search_creator_docs | Busca en la documentación por contenido de página; pasa path para leer una página completa. |
get_engine_api | Firmas, niveles de seguridad y deprecaciones del volcado de API en vivo. |
check_api_health | Verifica APIs antes de publicar: eliminadas, deprecadas, restringidas por seguridad, con yield. |
get_whats_new | Cambios recientes de la plataforma — para "esto funcionaba la semana pasada". |
get_weekly_recap | Cualquier resumen semanal de Roblox, actual o histórico. |
Cada herramienta es de solo lectura, devuelve Markdown con URLs de origen y se mantiene dentro de un presupuesto de tokens.
Ejemplo
"Mi DataStore:SetAsync sigue fallando con
502: API Services rejected request. ¿Esto es un problema del lado de Roblox?"
El agente ejecuta search_bugs sobre el texto del error, get_thread sobre el mejor resultado, y luego check_api_health antes de tocar tu código.
Configuración
Todo opcional.
| Variable | Predeterminado | Propósito |
|---|---|---|
DEVFORUM_CACHE_TTL | 300 | Duración de la caché de búsqueda, en segundos. |
DEVFORUM_TIMEOUT_MS | 12000 | Tiempo de espera por solicitud. |
DEVFORUM_MAX_RETRIES | 3 | Reintentos en 429 y 5xx. |
DEVFORUM_CONCURRENCY | 4 | Solicitudes simultáneas al DevForum. |
DEVFORUM_CDN_CONCURRENCY | 8 | Solicitudes simultáneas a la documentación alojada en GitHub. |
DEVFORUM_DOCS_SCAN | 14 | Páginas de documentación puntuadas por búsqueda. |
DEVFORUM_CACHE_DIR | Directorio temporal del sistema | Donde se almacenan en caché el volcado de API y el índice de documentación. |
DEVFORUM_BASE_URL | https://devforum.roblox.com | Apunta a otra instancia de Discourse. |
GITHUB_TOKEN | — | Aumenta el límite de tasa de GitHub para el listado de archivos de documentación. |
Un valor incorrecto se ignora, con una nota en stderr, y se usa el predeterminado.
Fuentes de datos
devforum.roblox.com (API pública de Discourse), Roblox/creator-docs y el Roblox-Client-Tracker volcado de API.
No está afiliado ni respaldado por Roblox Corporation.
Desarrollo
npm install && npm run build
npm test # offline unit and server tests
npm run inspect # MCP Inspector against the built server
Licencia
MIT