Skip to content

sandraschi/godot-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Godot MCP

Just Ruff Python FastMCP

CI AI-driven Godot 4.0 engine control via MCP tools. Import STL/GLB/OBJ geometry, load CFD velocity fields, spawn GPU particle systems, assign PBR materials, control cameras, and export HTML5 builds — all through FastMCP 3.2 tools over SSE transport. Designed as the visualization endpoint for the fleet CAD→CFD→render pipeline (qcad-mcp → freecad-mcp → FluidX3D → godot-mcp) and the blender-mcp → godot-mcp game asset pipeline.

Contents

Quick Start

just bootstrap       # uv sync + npm install + Godot
just serve           # MCP + REST (10993)
just godot-bridge    # TCP bridge in Godot (9080) — required for engine tools
just bridge-test     # confirm godot_status
just web             # dashboard (10992)

Or .\start.ps1 for backend + webapp only (start bridge separately).

Play a sample game: just demo-list then just demo-run platformer (see samples/README.md).

Export & ship a sample: just little-game-export web dodge then open /ship in the dashboard, or just ship web dodge (requires BUTLER_API_KEY + ITCH_TARGET).

Steam (partner publishing): requires $100 Steam Direct + your own App ID — no free playground like itch. See Ship to Steam and STEAM_PUBLISHING.md. Quick path: start steam-mcp on 11020, set STEAM_APP_ID / STEAM_DEPOT_ID / STEAM_USERNAME / STEAMCMD_PATH, then just steam-ship-beta game=dodge dry_run=true or /ship-steam.

Key Features

  • Game Builder — 6 new MCP tools: design_game, generate_game_worlds, compose_game_scene, generate_game_logic, export_and_ship, build_game. Natural language → GamePlan → Marble worlds → Godot scene → GDScript → HTML5. See SPEC.
  • 7 Steam ship toolssteam_status, steam_checklist, steam_stage_build, ship_to_steam_prerelease, ship_to_steam_release, ship_to_steam (+ monetization guide). Export Windows → _exchange → steam-mcp VDF/steamcmd. dry_run=true by default.
  • 6 itch ship toolsitch_status, godot_export_release, itch_push_preview, itch_push, itch_latest_version, ship_to_itch
  • Godot 4 engine control — scene graph via TCP bridge (port 9080)
  • Multi-format import — STL (binary), GLB/GLTF (via GLTFDocument), OBJ (via ResourceLoader)
  • CFD velocity fields — load FluidX3D data, animate streamlines with GPU particles
  • PBR materials — assign physically-based materials to any mesh surface
  • HTML5 export — build WebAssembly/WebGL with godot --headless --export-release fallback
  • itch.io shipping — Butler push from CLI, MCP, REST, or dashboard /ship (export → preview → push)
  • Steam partner shipping — Windows export → fleet exchange → steam-mcp SteamPipe upload; dashboard /ship-steam; beta branch testing on your App ID (not Spacewar/480)
  • REST API — FastAPI gateway on port 10993 alongside MCP SSE
  • Tauri native wrappernative/ directory for desktop distribution (~5 MB)

Cross-Repo Pipeline

qcad-mcp (DXF/STL) → freecad-mcp (BIM/IFC) → FluidX3D (GPU CFD)
                                                  ↓
                                          CSV velocity field
                                                  ↓
                                          godot-mcp (import + visualize)
                                                  ↓
                              ┌───────────────────┼───────────────────┐
                              ↓                   ↓                   ↓
                        Resonite (XR)      Web (HTML5)        Tauri (native)

License

MIT — see LICENSE.

About

AI-driven Godot 4 engine control via FastMCP 3.2 tools. STL import, CFD velocity fields, GPU particles, PBR materials, HTML5 export — the fleet visualization endpoint for CAD→CFD→render pipeline.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors