godot-docs-mcp

Un servidor MCP que sirve la documentación de Godot Engine a agentes de codificación con IA.

Godot está subrepresentado en los datos de entrenamiento de LLM en comparación con Unity y Unreal, por lo que los agentes alucinan habitualmente las APIs de GDScript, inventan nombres de nodos y aplican modismos de Godot 3.x a proyectos 4.x. Este servidor los ancla en la documentación real: búsqueda de texto completo en el manual y los tutoriales, además de una referencia de clases estructurada construida a partir de los metadatos de la API del propio motor.

Construido sobre la revisión 2026-07-28 de la especificación MCP mediante el mcp oficial del SDK de Python v2, que también sirve todas las revisiones anteriores del protocolo desde el mismo servidor.

Estado: en desarrollo. El servidor, sus herramientas y recursos, la línea de comandos y el flujo de trabajo semanal que publica el índice funcionan, y se publica un índice precompilado para Godot 4.7, por lo que sync instala uno sin necesidad de compilar. Aún no está en PyPI — se instala desde git, como se muestra a continuación. El empaquetado como plugin de Claude Code, con skills, es una fase posterior.

Cómo funciona

La documentación se indexa localmente en una única base de datos SQLite, por lo que las consultas son rápidas y funcionan sin conexión a internet.

docs.godotengine.org está detrás de un desafío de Cloudflare que rechaza a los clientes que no son navegadores, por lo que el sitio renderizado no se utiliza como fuente. Todo proviene de GitHub.

Related MCP server: Godot MCP Documentation Server

Primeros pasos

Instala el índice precompilado. Es una única descarga de unos 8 MB, y solo tiene que ocurrir una vez por versión de Godot.

uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp sync
uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp status

Luego apunta un cliente hacia él. Para Claude Code:

claude mcp add godot-docs -- \
  uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp

¿No hay un índice publicado para la versión que quieres, o estás trabajando en los analizadores? Construye uno desde el código fuente en su lugar. Eso requiere git y tarda aproximadamente un minuto:

uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp sync --rebuild

Pregunta algo que un modelo suele fallar — "¿cuál es la firma correcta de 4.x para move_and_slide?" — y la respuesta debería provenir de get_godot_class_member como bool move_and_slide(), sin argumentos. Tardó varios intentos en Godot 3.x, que es lo que la mayoría de los datos de entrenamiento recuerdan.

Comandos

Cada ajuste también es una variable de entorno, con el prefijo GODOT_DOCS_MCP_ — consulta config.py para la tabla completa.

Mantenerse actualizado

La documentación se mueve sin previo aviso, por lo que dos mecanismos la rastrean de forma independiente.

Un flujo de trabajo semanal comprueba si los commits del repositorio upstream han cambiado y, si es así, reconstruye el índice, consulta todo el corpus para confirmar que responde correctamente y lo publica como un archivo de lanzamiento. godot-docs-mcp sync es cómo te llega.

Un servidor en ejecución comprueba una vez al día, en segundo plano, si se ha publicado un índice más reciente. Nunca lo descarga — un índice desactualizado sigue respondiendo correctamente para la versión con la que se construyó, y reemplazarlo es decisión tuya. Lo que hace en su lugar es informarte: en godot://status, y como un notice de una línea en los resultados de búsqueda. Si la comprobación no puede ejecutarse, la respuesta es "could not check", nunca "up to date".

Herramientas

Cada herramienta es de solo lectura, y cada respuesta está limitada para que una sola llamada no desplace el resto de la conversación que pretendía informar. Una respuesta truncada lo indica y nombra la llamada que devuelve el resto.

Recursos

Las 515 páginas y 1.078 clases están deliberadamente no enumeradas en resources/list. Las plantillas son los URI que cada herramienta ya devuelve, por lo que un resultado de búsqueda se puede seguir sin necesidad de otra llamada a la herramienta.

Desarrollo

Requiere uv.

uv sync --dev
uv run pre-commit install

Consulta CLAUDE.md para la arquitectura y las convenciones de contribución.

Licencia

MIT. La documentación de Godot en sí está licenciada bajo CC BY 4.0 por Juan Linietsky, Ariel Manzur y la comunidad de Godot; este proyecto redistribuye una forma indexada de la misma y no altera esa licencia.