Better Godot MCP
Better Godot MCP
mcp-name: io.github.n24q02m/better-godot-mcp
Zusammengesetzter MCP-Server für die Godot Engine -- 17 Mega-Tools für KI-gestützte Spieleentwicklung
Funktionen
17 zusammengesetzte Mega-Tools -- Szene, Node, Skript, Shader, Animation, Tilemap, Physik, Audio, Navigation, UI und mehr
Volle Szenenkontrolle -- Erstellen, Parsen und Ändern von
.tscn-Dateien direkt, ohne dass Godot läuftGDScript CRUD -- Erstellen, Lesen, Schreiben und Anhängen von Skripten in einem einzigen Aufruf
Gestufte Token-Optimierung -- komprimierte Beschreibungen +
help-Tool bei Bedarf
Related MCP server: Godot MCP Unified
Einrichtung
Mit KI-Agent -- kopieren Sie dies und senden Sie es an Ihren KI-Agenten:
Bitte richte @n24q02m/better-godot-mcp für mich ein. Folge dieser Anleitung: https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md
Manuelle Einrichtung -- folgen Sie docs/setup-manual.md
Tools
Tool | Aktionen | Beschreibung |
|
| Projekt-Metadaten, Ausführen/Stoppen und Einstellungen |
|
| Szenendatei-Verwaltung |
|
| Manipulation von Szenenbaum-Nodes |
|
| GDScript-Datei CRUD |
|
| Godot-Editor starten und Status prüfen |
|
| Serverkonfiguration und Umgebungserkennung |
|
| Ressourcendatei-Verwaltung |
|
| Eingabe-Aktions- und Event-Mapping |
|
| Signalverbindungen |
|
| Animations-Player und Tracks |
|
| TileMap- und TileSet-Verwaltung |
|
| Shader-Datei CRUD mit Godot 4-Syntax |
|
| Kollisionsebenen und physikalische Körper |
|
| Audio-Bus- und Effektverwaltung |
|
| Navigationsregionen, Agents und Hindernisse |
|
| UI-Control-Erstellung und Theming |
| - | Vollständige Dokumentation für jedes Tool abrufen |
Konfiguration
Die Godot-Binärdatei wird automatisch an gängigen Installationsorten und im PATH erkannt. Für die grundlegende Verwendung sind keine Umgebungsvariablen erforderlich. Optional können GODOT_PROJECT_PATH und GODOT_PATH gesetzt werden, um die Standardwerte zu überschreiben.
Variable | Erforderlich | Standard | Beschreibung |
| Nein | - | Standard-Projektpfad (Tools akzeptieren auch den Parameter |
| Nein | Automatisch erkannt | Pfad zur Godot-Binärdatei |
Einschränkungen
Erfordert eine Godot 4.x-Projektstruktur
Szenendateien (
.tscn) werden durch Textmanipulation geparst/geändert, nicht über die interne API von Godotrun/stop/export-Aktionen erfordern eine installierte Godot-BinärdateiDer Docker-Modus hat eingeschränkten Dateisystemzugriff (mounten Sie Ihr Projektverzeichnis)
Sicherheit
Binärerkennung -- Multi-Pfad-Godot-Erkennung (Umgebung, PATH, gängige Orte)
Projektvalidierung -- Überprüft vor Operationen, ob
project.godotexistiertPlattformübergreifend -- Pfadbehandlung für Windows, macOS, Linux
Aus Quellcode bauen
git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run devLizenz
MIT -- Siehe LICENSE.
Available Tools
17 toolsanimationC
Animation management. Actions: create_player|add_animation|add_track|add_keyframe|list. Use help tool for full docs.
Inputs: action (required), loop, name, parent, +7 more. Returns: object
audioC
Audio bus and stream management. Actions: list_buses|add_bus|add_effect|create_stream. Use help tool for full docs.
Inputs: action (required), bus, name, parent, +6 more. Returns: object
configAIdempotent
Server configuration and environment.
Actions (required params -> optional):
status: current config
set (key, value): update setting
detect_godot: find Godot binary path
check: verify project and Godot availability
Inputs: action (required), key, value. Returns: object
editorAIdempotent
Godot editor control.
Actions (required params -> optional):
launch (-> project_path): open editor
status (-> project_path): check if editor is running
For running the game, use project(action="run") instead.
Inputs: action (required), project_path. Returns: object
helpARead-onlyIdempotent
Full documentation. Omit topic for the overview; use a topic when compressed descriptions are insufficient.
Inputs: topic.
input_mapADestructive
Input action management.
Actions (required params -> optional):
list (-> project_path): all input actions
add_action (action_name -> deadzone=0.5, project_path)
remove_action (action_name -> project_path)
add_event (action_name, event_type, event_value -> project_path)
event_type: key | mouse | joypad. event_value: e.g., KEY_SPACE.
Inputs: action (required), deadzone, event_type, action_name, +2 more. Returns: object
nodesADestructive
Scene node operations.
Actions (required params -> optional):
add (scene_path, name -> type="Node", parent=".", project_path)
remove (scene_path, name -> project_path)
rename (scene_path, name, new_name -> project_path)
list (scene_path -> project_path)
set_property (scene_path, name, property, value -> project_path)
get_property (scene_path, name, property -> project_path)
Node paths: relative to scene root using "/" (e.g., "Player/Sprite2D"). Use "." for root.
Inputs: action (required), name, type, value, +5 more. Returns: object
physicsC
Physics config. Actions: layers|collision_setup|body_config|set_layer_name. Use help tool for full docs.
Inputs: action (required), mass, name, dimension, +6 more. Returns: object
projectA
Godot project operations.
Actions (required params -> optional):
info (-> project_path): project metadata
version: Godot engine version
run (-> scene_path, project_path): launch game
logs (-> pid): last captured stdout/stderr lines from a run (default: most recently started)
stop: stop running game
settings_get (key -> project_path): read project setting
settings_set (key, value -> project_path): write project setting
export (preset, output_path -> project_path): export game build
Inputs: action (required), key, pid, value, +4 more. Returns: object
resourcesBDestructive
Resource file management.
Actions (required params -> optional):
list (-> type, project_path): browse resources (type: image|audio|font|shader|scene|resource)
info (resource_path -> project_path): resource metadata
delete (resource_path -> project_path)
import_config (resource_path -> project_path): view import settings
Inputs: action (required), type, project_path, resource_path. Returns: object
scenesADestructive
Scene file (.tscn) CRUD.
Actions (required params -> optional):
create (scene_path -> root_type="Node2D", root_name, project_path)
list (-> project_path)
info (scene_path -> project_path)
delete (scene_path -> project_path)
duplicate (scene_path, new_path -> project_path)
set_main (scene_path -> project_path)
scene_path: relative to project root (e.g., "scenes/main.tscn"), NOT res:// prefix. Use nodes tool to edit nodes within a scene.
Inputs: action (required), new_path, root_name, root_type, +2 more. Returns: object
scriptsADestructive
GDScript file CRUD.
Actions (required params -> optional):
create (script_path -> extends="Node", content, project_path): generate template
read (script_path -> project_path)
write (script_path, content -> project_path): replace entire file
attach (script_path, scene_path, node_name -> project_path): link to scene node
list (-> project_path)
delete (script_path -> project_path)
script_path: relative to project root (e.g., "scripts/player.gd").
Inputs: action (required), content, extends, node_name, +3 more. Returns: object
shaderC
Godot shader management. Actions: create|read|write|get_params|list. Use help tool for full docs.
Inputs: action (required), content, shader_path, shader_type, +1 more. Returns: object
signalsADestructive
Signal connection management.
Actions (required params -> optional):
list (scene_path -> project_path): all signal connections
connect (scene_path, signal, from, to, method -> flags, project_path)
disconnect (scene_path, signal, from, to, method -> project_path)
Inputs: action (required), to, from, flags, +4 more. Returns: object
tilemapC
TileSet and TileMap management. Actions: create_tileset|add_source|set_tile|paint|list. Use help tool for full docs.
Inputs: action (required), tile_size, scene_path, project_path, +2 more. Returns: object
uiC
UI Control nodes and themes. Actions: create_control|set_theme|layout|list_controls. Use help tool for full docs.
Inputs: action (required), name, type, parent, +5 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a distinct Godot subsystem, and explicit notes (e.g., editor launch vs project run) reduce confusion. Some overlap remains between project settings and config, and between scenes and generic resource management.
Tool names follow a consistent single-noun domain pattern with verb-style actions underneath. Minor inconsistencies like plural scenes/nodes/scripts vs singular animation/shader and the underscore in input_map prevent a perfect score.
At roughly 16-17 tools, the server sits at the upper edge of the ideal range, but each tool covers a separate Godot domain and earns its place. It is slightly heavy but not bloated.
The surface covers the core Godot development lifecycle: project, editor, scenes, scripts, resources, input, signals, rendering, physics, audio, navigation, and UI. Minor gaps exist, such as no generic resource creation and abbreviated documentation for several advanced domains.
Maintenance
Related MCP Connectors
Generate, search and export game-ready sprite sheets for Godot, Unity and other game engines.
Search, generate, refine, and export pixel art VFX for games, including sprite sheets and Godot 4.
Gamedev tools for AI agents: level design, renders, sprites, GLB optimizer. Pay per call with x402.
Make all the audio for your game from a single prompt. Describe your game and your AI assistant plans every sound it needs (sound effects, ambience loops, music tracks and character voice lines), then generates them all in one go. You get several AI versions of each sound and keep the ones you like. Sounds are organized per game in folders and scenes, and the free Godot plugin installs them into your project, ready to play with one line of code. Works with Claude, Claude Code, Cursor and any MCP client, with OAuth login (no API key needed). Free plan included; sounds can be used in commercial games.
Related MCP Servers
- AlicenseAqualityAmaintenanceMarkdown-first MCP server for Notion that provides 7 composite action-based tools consolidating 28+ REST API endpoints, enabling AI agents to efficiently manage pages, databases, blocks, and content with automatic pagination and bulk operations.101,730 npm36Apache 2.0
- AlicenseNot gradedqualityFmaintenanceEnables complete natural language control of Godot Engine 4.5+ with 76 tools for managing scripts, scenes, nodes, animations, physics, tilemaps, audio, shaders, navigation, particles, UI, lighting, assets, and exports. Integrates with Claude Desktop, VS Code, and Ollama for AI-assisted game development.2MIT
- AlicenseAqualityAmaintenanceWeb search (embedded SearXNG), content extraction, and library docs indexing with hybrid search. No API keys required.6733 PyPI24Apache 2.0
- AlicenseAqualityAmaintenancePersistent AI memory with SQLite hybrid search (FTS5 + semantic), built-in Qwen3 embedding, and rclone sync across machines.15585 PyPI13Apache 2.0