godot-docs-mcp

Ein MCP-Server, der die Godot Engine-Dokumentation für KI-Codierungsagenten bereitstellt.

Godot ist in den LLM-Trainingsdaten im Vergleich zu Unity und Unreal unterrepräsentiert, daher erfinden Agenten regelmäßig GDScript-APIs, erfinden Knotennamen und wenden Godot-3.x-Idiome auf 4.x-Projekte an. Dieser Server verankert sie in den echten Dokumenten: Volltextsuche über das Handbuch und Tutorials sowie eine strukturierte Klassenreferenz, die aus den eigenen API-Metadaten der Engine erstellt wurde.

Basierend auf der MCP-Spezifikationsrevision 2026-07-28 über das offizielle mcp Python SDK v2, das auch alle früheren Protokollrevisionen vom selben Server bereitstellt.

Status: in Entwicklung. Der Server, seine Tools und Ressourcen, die Befehlszeile und der wöchentliche Workflow, der den Index veröffentlicht, funktionieren alle, und ein vorgefertigter Index für Godot 4.7 ist veröffentlicht, sodass sync einen ohne Build installiert. Noch nicht auf PyPI – installieren Sie von git, wie unten. Die Verpackung als Claude-Code-Plugin mit Skills ist eine spätere Phase.

So funktioniert es

Die Dokumentation wird offline in einer einzigen SQLite-Datenbank indiziert, sodass Abfragen schnell sind und ohne Netzwerkverbindung funktionieren.

docs.godotengine.org steht hinter einer Cloudflare-Herausforderung, die Nicht-Browser-Clients ablehnt, daher wird die gerenderte Website nicht als Quelle verwendet. Alles kommt von GitHub.

Related MCP server: Godot MCP Documentation Server

Erste Schritte

Installieren Sie den vorgefertigten Index. Es ist ein Download von etwa 8 MB, und er muss nur einmal pro Godot-Version erfolgen.

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

Dann richten Sie einen Client darauf aus. Für Claude Code:

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

Kein Index für die gewünschte Version veröffentlicht oder an den Parsern arbeiten? Bauen Sie stattdessen einen aus dem Quellcode. Das benötigt git und dauert etwa eine Minute:

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

Fragen Sie etwas, das ein Modell zuverlässig falsch macht – „Was ist die korrekte 4.x-Signatur für move_and_slide?“ – und die Antwort sollte von get_godot_class_member als bool move_and_slide() zurückkommen, ohne Argumente. In Godot 3.x waren es mehrere Argumente, woran sich die meisten Trainingsdaten erinnern.

Befehle

Jede Einstellung ist auch eine Umgebungsvariable mit dem Präfix GODOT_DOCS_MCP_ – siehe config.py für die vollständige Tabelle.

Aktuell bleiben

Die Dokumentation bewegt sich ohne Vorwarnung, daher verfolgen zwei Dinge sie unabhängig.

Ein wöchentlicher Workflow prüft, ob sich die Upstream-Commits bewegt haben, und wenn ja, baut er den Index neu auf, fragt den gesamten Korpus ab, um zu bestätigen, dass er antwortet, und veröffentlicht ihn als Release-Asset. godot-docs-mcp sync ist der Weg, wie das zu Ihnen gelangt.

Ein laufender Server prüft einmal täglich im Hintergrund, ob ein neuerer Index veröffentlicht wurde. Er lädt nie einen herunter – ein Index, der zurückliegt, antwortet weiterhin korrekt für die Version, aus der er erstellt wurde, und das Ersetzen liegt bei Ihnen. Stattdessen sagt er es: in godot://status und als einzeilige notice bei Suchergebnissen. Wenn die Prüfung nicht ausgeführt werden kann, lautet die Antwort „konnte nicht geprüft werden“, nie „aktuell“.

Tools

Jedes Tool ist schreibgeschützt, und jede Antwort ist begrenzt, sodass ein Aufruf nicht das Gespräch verdrängen kann, das er informieren soll. Eine Antwort, die abgeschnitten wurde, sagt das und nennt den Aufruf, der den Rest zurückgibt.

Ressourcen

Die 515 Seiten und 1.078 Klassen sind bewusst nicht in resources/list aufgelistet. Die Vorlagen sind die URIs, die jedes Tool bereits zurückgibt, sodass ein Suchergebnis vom Host verfolgt werden kann, ohne einen weiteren Tool-Aufruf.

Entwicklung

Erfordert uv.

uv sync --dev
uv run pre-commit install

Siehe CLAUDE.md für die Architektur und Beitragskonventionen.

Lizenz

MIT. Die Godot-Dokumentation selbst ist unter CC BY 4.0 von Juan Linietsky, Ariel Manzur und der Godot-Community lizenziert; dieses Projekt verteilt eine indizierte Form davon weiter und ändert diese Lizenz nicht.