{
  "markdown": "# 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",
  "bytes": 4644,
  "sha": "8d01633f7fafb38b202a1c92c82c1ffd6b990d17cbadac6ff1cf428e0f36caa5",
  "repo_slug": "sandraschi/godot-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sandraschi_godot_mcp_e7de4657/readme"
}