{"id":"b3dfeff9-c5dc-4c2c-bd11-2de53101fd5d","slug":"sandraschi-godot-mcp","kind":"mcp","name":"godot-mcp","summary":"Godot 4 automation via FastMCP — scene/mesh/PBR/particles, STL import, HTML5 export. For Cursor / Claude Desktop. Webapp.","owner":"sandraschi","repoUrl":"https://github.com/sandraschi/godot-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":6,"match":null,"fewStars":false,"format":"mcp","createdAt":"2026-05-18T15:33:08.000Z","addedAt":"2026-10-14T06:03:03.183Z","logoUrl":"https://avatars.githubusercontent.com/u/34750307?u=166281f79cd1114c24ba073dc02fd578660cbff0&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["browser-web","cloud-infra","data-analytics"],"tags":["3d-visualization","ai-game-dev","cfd","fastmcp","fluid-dynamics","game-development","godot","godot-engine"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-15T01:57:48.699Z","sample":false,"url":"https://conduits.dev/tools/sandraschi-godot-mcp","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Godot MCP\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square\" alt=\"Just\">\n  <img src=\"https://img.shields.io/badge/Python-3.13-3776AB?style=flat-square\" alt=\"Python\">\n  <img src=\"https://img.shields.io/badge/FastMCP-3.4-7c5cfc?style=flat-square\" alt=\"FastMCP\">\n  <img src=\"https://img.shields.io/badge/tier-T3--desktop-7c5cfc?style=flat-square\" alt=\"Release Tier\">\n</p>\n\nAI-driven Godot 4 control via MCP — scene manipulation, 3D import, GPU particles,\nprocedural textures, HTML5 export. **Deterministic playtesting**: freeze the game\nclock, inject analog/joypad/mouse input, step frame-by-step until a condition is\nmet, read live game state as structured JSON. **Game Builder**: describe a game\nin natural language and get playable GDScript + export. Publish to itch.io and\nSteam. 95+ tools, 77 tests, NSIS desktop installer.\n\n---\n\n## Quick Install\n\n```powershell\ngit clone https://github.com/sandraschi/godot-mcp\ncd godot-mcp\njust bootstrap       # install deps\njust serve           # start server (10993)\njust web             # open dashboard (10992)\n```\n\nSee [INSTALL.md](INSTALL.md) for all options (MCPB, dev setup, naked PC).\n\n---\n\n## Features\n\n- **Game Builder** — `design_game` -> `generate_game_logic` -> `generate_game_tests` -> `generate_dialogue` -> export. Validated with gdlint + godot --check-only, auto-repaired by LLM. [Tutorial](docs/game-builder-tutorial.md)\n- **Procedural textures** — `godot_generate_procedural_texture`: gradient, noise, checker, solid. No external assets needed.\n- **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.\n- **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.\n- **Engine control** — 30 bridge tools: import STL/GLB/OBJ, particles, cameras, lighting, animation, viewport capture, input simulation, scene node management.\n- **Animation keyframe editor** — query tracks down to individual keyframes, insert/remove keys, set interpolation.\n- **TileMap/GridMap editing** — read and write cell data directly (bypasses base64 `.tscn` serialization).\n- **Performance profiler** — 14 engine metrics with auto-sampling and spike detection (>2 stddev).\n- **Mesh validation** — scan for NaN vertices, degenerate triangles, zero normals.\n- **3D Gaussian Splat import** — import `.ply` and `.spz` files with a custom billboarded Gaussian shader (per-splat scale, SH DC color).\n- **Publishing** — `itch_ops` and `steam_ops` portmanteaus for itch.io Butler and SteamPipe. Cross-repo fleet pipeline.\n- **GDScript validation** — two-pass (gdlint style + godot compile) with LLM repair. \n- **Plugin ecosystem** — 7 community plugins installable from the `/plugins` page.\n- **LLM detection** — auto GPU probe, model recommendation by VRAM tier. Default `gemma4:12b`.\n- **Sample game** — [Vibecoder Runner](samples/vibecode-runner/) with 10 AI-themed enemy types.\n\n## What You Can Do\n\n```powershell\njust gb-demo \"A 2D runner where you collect stars and avoid spikes\"\njust bridge-test                          # check engine connection\njust demo-run vibecode                    # play sample game\njust gb-preview                           # preview latest HTML5 export\n```\n\n## Documentation\n\n| Doc | Contents |\n|-----|----------|\n| [Installation](INSTALL.md) | All install methods |\n| [Configuration](docs/CONFIGURATION.md) | Env vars, settings |\n| [Tool Reference](docs/TOOLS.md) | All 90+ MCP tools |\n| [Playtesting Spec](docs/SPEC_DETERMINISTIC_PLAYTESTING.md) | Deterministic playtesting architecture |\n| [Demo Scripts](demos/) | Playtesting, profiling, scene inspection, splat import demos |\n| [Game Builder Tutorial](docs/game-builder-tutorial.md) | Prompt-to-game walkthrough |\n| [Godot Ecosystem](docs/godot-ecosystem.md) | Plugins, gdtoolkit, fleet pipeline |\n| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues |\n| [API Reference](docs/api.md) | REST endpoints |\n| [Development](docs/DEVELOPMENT.md) | Contributing, local setup |\n\n## Requirements\n\n- **Godot 4.4+** (for engine bridge tools) — `just install-godot` or [godotengine.org](https://godotengine.org)\n- **Python 3.13+** + **uv** — `winget install astral-sh.uv`\n- **Bun** — `winget install oven-sh.bun`\n- **Ollama** (optional, for game builder) — `winget install Ollama.Ollama` then `ollama pull gemma4:12b`\n- **Rust** (optional, for NSIS build) — `rustup.rs`\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n"}