Allows publishing and managing Godot game builds on itch.io via Butler (itch_ops), including cross-repo fleet publishing pipelines.
Integrates with Ollama for local LLM inference backing the Game Builder: auto GPU probe and model recommendation by VRAM tier (default gemma4:12b) to generate, validate, and auto-repair GDScript game logic.
Allows publishing and managing Godot game builds to Steam via SteamPipe (steam_ops), including cross-repo fleet publishing pipelines.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Godot MCP make a 2D runner where I collect stars and avoid spikes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI-driven Godot 4 control via MCP — scene manipulation, 3D import, GPU particles, procedural textures, HTML5 export. Deterministic playtesting: freeze the game clock, inject analog/joypad/mouse input, step frame-by-step until a condition is met, read live game state as structured JSON. Game Builder: describe a game in natural language and get playable GDScript + export. Publish to itch.io and Steam. 95+ tools, 77 tests, NSIS desktop installer.
git clone https://github.com/sandraschi/godot-mcp
cd godot-mcp
just bootstrap # install deps
just serve # start server (10993)
just web # open dashboard (10992)See INSTALL.md for all options (MCPB, dev setup, naked PC).
Related MCP server: Godot MCP
Game Builder — design_game -> generate_game_logic -> generate_game_tests -> generate_dialogue -> export. Validated with gdlint + godot --check-only, auto-repaired by LLM. Tutorial
Procedural textures — godot_generate_procedural_texture: gradient, noise, checker, solid. No external assets needed.
Deterministic playtesting — freeze game clock, step frame-by-step, step-until GDScript condition, analog/joypad/mouse/text input injection. Three-phase implementation inspired by satelliteoflove/godot-mcp.
Structured game state — godot_state_digest reads live node state as JSON via _mcp_state() convention or auto-collected properties. Cheaper than full scene tree dump.
Engine control — 30 bridge tools: import STL/GLB/OBJ, particles, cameras, lighting, animation, viewport capture, input simulation, scene node management.
Animation keyframe editor — query tracks down to individual keyframes, insert/remove keys, set interpolation.
TileMap/GridMap editing — read and write cell data directly (bypasses base64 .tscn serialization).
Performance profiler — 14 engine metrics with auto-sampling and spike detection (>2 stddev).
Mesh validation — scan for NaN vertices, degenerate triangles, zero normals.
3D Gaussian Splat import — import .ply and .spz files with a custom billboarded Gaussian shader (per-splat scale, SH DC color).
Publishing — itch_ops and steam_ops portmanteaus for itch.io Butler and SteamPipe. Cross-repo fleet pipeline.
GDScript validation — two-pass (gdlint style + godot compile) with LLM repair.
Plugin ecosystem — 7 community plugins installable from the /plugins page.
LLM detection — auto GPU probe, model recommendation by VRAM tier. Default gemma4:12b.
Sample game — Vibecoder Runner with 10 AI-themed enemy types.
just gb-demo "A 2D runner where you collect stars and avoid spikes"
just bridge-test # check engine connection
just demo-run vibecode # play sample game
just gb-preview # preview latest HTML5 exportDoc | Contents |
All install methods | |
Env vars, settings | |
All 90+ MCP tools | |
Deterministic playtesting architecture | |
Playtesting, profiling, scene inspection, splat import demos | |
Prompt-to-game walkthrough | |
Plugins, gdtoolkit, fleet pipeline | |
Common issues | |
REST endpoints | |
Contributing, local setup |
Godot 4.4+ (for engine bridge tools) — just install-godot or godotengine.org
Python 3.13+ + uv — winget install astral-sh.uv
Bun — winget install oven-sh.bun
Ollama (optional, for game builder) — winget install Ollama.Ollama then ollama pull gemma4:12b
Rust (optional, for NSIS build) — rustup.rs
MIT — see LICENSE.
This server cannot be deployed
Turn prompts into production-ready game assets: animated characters, textures, terrain, VFX, HUD.
AI game assets for agents: consistent sprites, 2D animations, tiles, maps, music and engine exports.
Discover AI tools for game development — 100+ tools indexed by engine, task, and pricing.
Generate game assets with AI: sprites, animations, 3D models with rigging, video, music, SFX, voices
