Godot MCP Unified - KI-Architektur + Godot

Dokumentation für mein zukünftiges Ich - Vollständige Konfiguration für das Programmieren in natürlicher Sprache in Godot

Auf Englisch lesen

Globale Architektur

                    +------------------+
                    |   Claude Code    |
                    |    (VS Code)     |
                    +--------+---------+
                             |
                             v
+----------------+  +--------+---------+  +------------------+
| Claude Desktop |->|                  |<-| ollmcp (Ollama)  |
|   (Anthropic)  |  | godot-mcp-unified|  | qwen2.5-coder:7b |
+----------------+  |   (ce serveur)   |  +------------------+
                    +--------+---------+
                             |
              +--------------+--------------+
              |                             |
              v                             v
     +--------+---------+          +--------+---------+
     |  Godot CLI       |          |  Plugin WebSocket|
     |  (--headless)    |          |  (addons/godot_  |
     |  Fallback mode   |          |   mcp/) Port 6505|
     +------------------+          +------------------+
              |                             |
              +-------------+---------------+
                            |
                            v
                   +--------+---------+
                   |  Godot Engine    |
                   |    4.5.1         |
                   +------------------+

Kommunikation mit Godot

Der Server erkennt automatisch, ob das Plugin verbunden ist, und verwendet den optimalen Modus.

Was dieser Server ermöglicht

ALLES in Godot per natürlicher Sprache erledigen (83 Werkzeuge + 20 Ressourcen + 20 Prompts):

Installation (bereits erledigt)

Installierte Voraussetzungen

• Node.js (für den MCP-Server)

• Godot 4.5.1: C:\Dev\Godot_v4.5.1-stable_win64.exe\Godot_v4.5.1-stable_win64_console.exe

• uv (moderner Python-Manager)

• ollmcp (Ollama <-> MCP Bridge)

Dieser Server

cd C:\Dev\godot-mcp-unified
npm install
npm run build

Konfiguration

Claude Desktop (C:\Users\pierr\AppData\Roaming\Claude\claude_desktop_config.json)

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["C:\\Dev\\godot-mcp-unified\\build\\index.js"],
      "env": {
        "GODOT_PATH": "C:\\Dev\\Godot_v4.5.1-stable_win64.exe\\Godot_v4.5.1-stable_win64_console.exe"
      }
    }
  }
}

VS Code / Claude Code (.vscode/mcp.json in deinem Godot-Projekt)

{
  "servers": {
    "godot": {
      "command": "node",
      "args": ["C:\\Dev\\godot-mcp-unified\\build\\index.js"],
      "env": {
        "GODOT_PATH": "C:\\Dev\\Godot_v4.5.1-stable_win64.exe\\Godot_v4.5.1-stable_win64_console.exe"
      }
    }
  }
}

Ollama (via ollmcp)

# Lancer le bridge
ollmcp --model qwen2.5-coder:7b C:\Dev\godot-mcp-unified\build\index.js

# Ou via ollama-gateway (port 3010)

Verfügbare Ollama-Modelle

Hinweis: Die -chess-Modelle sind NICHT zum Schachspielen gedacht, sondern personalisierte Assistenten für die Entwicklung der chess-app mit FFE-System-Prompts.

API-Referenz (83 Werkzeuge + 20 Ressourcen + 20 Prompts)

Statistiken

Primitives MCP:
  Tools:     83/83   ████████████████████ 100%
  Resources: 20/20   ████████████████████ 100%
  Prompts:   20/20   ████████████████████ 100%

Qualite:
  Tests:    3170+    ████████████████████ 100% pass (69 suites)
  Coverage:  85%     █████████████████░░░  85%

Bridge Plugin:
  Avec bridge:  47 outils (utilisent WebSocket si plugin actif)
  Sans bridge:  35 outils (CLI/file I/O uniquement)

Projektverwaltung (14 Werkzeuge)

• launch_editor - Godot-Editor öffnen

• run_project - Projekt starten

• stop_project - Projekt stoppen

• list_projects - Projekte in einem Ordner auflisten

• get_project_info - Projektinformationen abrufen

• get_godot_version - Godot-Version

• get_project_settings - Projekteinstellungen lesen

• set_project_setting - Einstellung ändern

• manage_input_actions - Input-Aktionen verwalten

• manage_autoloads - Autoloads verwalten

• validate_project - Projektstruktur validieren

• convert_project - Godot 3 zu 4 Projektkonvertierung

• validate_conversion - Konvertierung validieren

• generate_docs - GDScript-Dokumentation generieren

Szenenverwaltung (15 Werkzeuge)

• create_scene - Neue Szene erstellen

• add_node - Node hinzufügen

• edit_node - Node-Eigenschaften bearbeiten

• remove_node - Node löschen

• rename_node - Node umbenennen

• move_node - Node verschieben (Reparent)

• duplicate_node - Node duplizieren

• load_sprite - Textur laden

• save_scene - Szene speichern

• instance_scene - Szene instanziieren

• list_scenes - Szenen auflisten

• get_node_tree - Szenenbaum abrufen

• connect_signal - Signal verbinden

• manage_groups - Node-Gruppen verwalten

• export_mesh_library - Als MeshLibrary exportieren

GDScript-Skripte (7 Werkzeuge)

• list_scripts - Alle .gd-Dateien des Projekts auflisten

• read_script - Skriptinhalt lesen

• write_script - Skript erstellen/bearbeiten

• delete_script - Skript löschen

• attach_script - Skript an Node anhängen

• detach_script - Skript von Node trennen

• get_script_errors - Kompilierungsfehler abrufen

Animation (7 Werkzeuge)

• create_animation_player - AnimationPlayer erstellen

• add_animation - Animation hinzufügen

• add_animation_track - Track hinzufügen (Wert, Position, Rotation, etc.)

• set_keyframe - Keyframe mit Transition/Easing definieren

• create_animation_tree - AnimationTree erstellen

• setup_state_machine - State Machine konfigurieren

• blend_animations - Animations-Blending konfigurieren

Physik (3 Werkzeuge)

• create_collision_shape - CollisionShape2D/3D erstellen

• setup_rigidbody - RigidBody konfigurieren (Masse, Schwerkraft)

• configure_physics_layers - 2D/3D-Physik-Layer benennen

TileMap (5 Werkzeuge)

• create_tileset - TileSet mit Kachelgröße erstellen

• create_tilemap_layer - TileMapLayer erstellen

• set_tile - Kachel platzieren

• paint_tiles - Kacheln im Batch malen

• import_ldtk_level - LDtk-Level importieren

Audio (3 Werkzeuge)

• create_audio_bus - Audio-Bus erstellen

• setup_audio_player - AudioStreamPlayer konfigurieren

• add_audio_effect - Effekt hinzufügen (Reverb, Delay, EQ)

Shader (2 Werkzeuge)

• create_shader - .gdshader-Datei erstellen

• create_shader_material - ShaderMaterial erstellen

Navigation (2 Werkzeuge)

• create_navigation_region - NavigationRegion2D/3D erstellen

• bake_navigation_mesh - Navmesh backen

Partikel (2 Werkzeuge)

• create_gpu_particles - GPUParticles2D/3D erstellen

• create_particle_material - ParticleProcessMaterial erstellen

UI (2 Werkzeuge)

• create_ui_container - Container erstellen (VBox, HBox, Grid, etc.)

• create_control - Control erstellen (Button, Label, etc.)

Beleuchtung (3 Werkzeuge)

• create_light - Light2D/3D erstellen (Directional, Omni, Spot)

• setup_environment - Umgebung konfigurieren (Nebel, Glow, SSAO)

• setup_lightmapper - LightmapGI und Baking konfigurieren

Assets (3 Werkzeuge)

• list_assets - Assets auflisten (Bilder, Audio, Modelle)

• import_asset - Externe Datei importieren

• reimport_assets - Reimport erzwingen

Export (3 Werkzeuge)

• export_project - Projekt exportieren

• export_pack - Nur PCK exportieren

• list_export_presets - Export-Presets auflisten

Batch-Operationen (1 Werkzeug)

• batch_operations - Mehrere MCP-Werkzeuge nacheinander ausführen

Debug (5 Werkzeuge)

• get_debug_output - Konsolenausgabe abrufen

• start_debug_stream - Debug-WebSocket-Server starten

• stop_debug_stream - WebSocket-Server stoppen

• get_debug_stream_status - Serverstatus abrufen

• take_screenshot - Screenshot aufnehmen

UID (Godot 4.4+) (2 Werkzeuge)

• get_uid - UID einer Datei abrufen

• update_project_uids - Referenzen aktualisieren

System (2 Werkzeuge)

• system_health - Systemzustand prüfen

• get_godot_version - Godot-Version

Anwendungsbeispiele

Einen Spielercharakter erstellen

"Cree une scene Player.tscn avec un CharacterBody2D comme root,
ajoute un Sprite2D nomme 'Sprite' et un CollisionShape2D nomme 'Collision'"

Ein Projekt debuggen

"Lance mon projet Godot et montre-moi les erreurs dans la console"

Eine bestehende Szene bearbeiten

"Dans la scene Player.tscn, change la position du Sprite a (100, 50)
et sa scale a 2x"

Struktur von Godot-Projekten

C:\Dev\
├── jdvlh-godot-client\     <- Projet principal (pas de remote git configure!)
│   ├── project.godot
│   ├── .vscode\mcp.json    <- Config MCP pour ce projet
│   └── addons\godot_mcp\   <- Plugin MCP copie
│
├── jdvlh-godot\            <- Projet vide (a garder pour tests)
│
└── GodotDynamicDialog\     <- Fork de dynamic-dialog

Ursprung des Codes

Dieser Server vereint die Funktionen von 3 Open-Source-Projekten:

Hinweis: GDAI MCP existiert, ist aber kostenpflichtig ($19).

Maschinen-Spezifikationen

• CPU: Ryzen 5 5600H

• RAM: 16 GB

• GPU: AMD Radeon (integriert) - kein CUDA

• Optimale Quantisierung: Q4_K_M (Sweet Spot für Qualität/Leistung)

Fehlerbehebung

Der Server startet nicht

cd C:\Dev\godot-mcp-unified
npm run build

Godot nicht gefunden

Überprüfen, ob GODOT_PATH auf die richtige ausführbare Datei zeigt (Konsolenversion, um Logs zu sehen).

Claude Desktop sieht die Werkzeuge nicht

Claude Desktop nach der Konfigurationsänderung neu starten.

Nützliche Befehle

# Rebuild le serveur
cd C:\Dev\godot-mcp-unified && npm run build

# Tester avec l'inspecteur MCP
npm run inspector

# Lister les modeles Ollama
ollama list

# Supprimer un modele Ollama
ollama rm nom_modele

TODO

• [ ] Git-Remote für jdvlh-godot-client konfigurieren

• [ ] Überflüssige Ollama-Modelle bereinigen (qwen2.5, gemma2, llama3.2, deepseek-coder-v2)

• [ ] Vollständige Integration mit einem neuen Projekt testen

Letztes Update: 11. Februar 2026 godot-mcp-unified v0.9.0 - 83 Werkzeuge + 20 Ressourcen + 20 Prompts Abdeckung: 85% | Tests: 3170+ (69 Suiten) | ISO 25010/29119/5055/27001 konform