GodotLens: KI-gestützte Code-Analyse für GDScript

Ein MCP-Server, der 15 semantische Analysetools für GDScript bereitstellt, basierend auf dem integrierten Language Server von Godot.

Entwickelt für KI-Agenten

KI-Coding-Agenten arbeiten mit Textdateien, verfügen jedoch nicht über ein semantisches Verständnis von GDScript. Wenn ein Agent grep verwendet, um Verwendungen einer Funktion zu finden, kann er nicht zwischen einem Funktionsaufruf und einem Kommentar mit demselben Namen, einer Signaldeklaration und einer Signalemission oder einer überschriebenen Methode und einer unabhängigen Funktion unterscheiden.

GodotLens schließt diese Lücke, indem es den integrierten Language Server von Godot über das Model Context Protocol (MCP) zugänglich macht. Dies verleiht KI-Agenten compiler-genaue Code-Intelligenz für GDScript – wie „Gehe zu Definition“, „Referenzen finden“, Diagnosen, Umbenennungen und mehr.

Beispiel: Alle Verwendungen von _on_player_hit finden:

Voraussetzungen

• Der Godot 4.x-Editor muss ausgeführt werden und Ihr Projekt muss geöffnet sein – der LSP-Server von Godot startet automatisch, wenn der Editor ein Projekt öffnet.

• Python 3.10+ (für die Installation via pip) oder Node.js 16+ (für npx).

Schnellstart

Option A: npx (empfohlen für MCP-Clients)

Fügen Sie dies Ihrer MCP-Konfiguration hinzu (z. B. .mcp.json für Claude Code):

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

Das npm-Paket bündelt den vollständigen Server (~20 KB Python). Keine externen Python-Abhängigkeiten.

Option B: pip

pip install godotlens-mcp

{
  "mcpServers": {
    "godotlens": {
      "command": "godotlens-mcp"
    }
  }
}

Konfiguration

Tools

Status

Navigation (6 Tools)

Refactoring

Synchronisation (3 Tools)

Batch-Operationen (3 Tools)

Diagnosen

Architektur

┌──────────────┐         ┌────────────────────┐         ┌───────────────────┐
│   AI Agent   │  stdio  │  GodotLens (MCP)   │   TCP   │  Godot Editor     │
│ (Claude, etc)├────────►│  JSON-RPC 2.0      ├────────►│  Built-in LSP     │
│              │◄────────┤  Python 3.10+      │◄────────┤  Port 6005        │
└──────────────┘         └────────────────────┘         └───────────────────┘

GodotLens fungiert als Brücke zwischen dem KI-Agenten und dem integrierten Language Server von Godot. Der KI-Agent kommuniziert mit GodotLens über MCP (JSON-RPC über stdio). GodotLens übersetzt MCP-Tool-Aufrufe in LSP-Anfragen und sendet diese über TCP an den Godot-Editor. Antworten werden für eine effiziente KI-Verarbeitung komprimiert.

Keine Abhängigkeiten – der Server verwendet ausschließlich die Python-Standardbibliothek. Die MCP- und LSP-Protokolle sind direkt implementiert, was den Server leicht und in sich geschlossen hält.

Wichtig: Dateisynchronisation

Der LSP von Godot erkennt Dateiänderungen, die außerhalb des Editors vorgenommen wurden, nicht automatisch. Wenn der KI-Agent eine .gd-Datei ändert, sollte er gdscript_sync_file oder gdscript_sync_files aufrufen, damit der LSP den geänderten Code neu analysiert. Ohne diesen Schritt können Diagnosen und Navigationsergebnisse veraltet sein.

Empfohlener Workflow:

1. GodotLens-Tools zur Code-Analyse verwenden

2. Änderungen in Dateien schreiben

3. gdscript_sync_file aufrufen, um den LSP-Status zu aktualisieren

4. GodotLens-Tools zur Überprüfung der Änderungen verwenden

Koordinatensystem

Alle Zeilen- und Zeichenparameter sind 0-indiziert, entsprechend der LSP-Spezifikation:

• Zeile 0, Zeichen 0 = erstes Zeichen der Datei

Lizenz

MIT-Lizenz – siehe LICENSE für Details.