Skip to content

youichi-uda/godot-mcp-pro

MCP Developer Tools

A premium MCP server that bridges AI assistants like Claude to the Godot game engine via WebSocket, providing real‑time editor integration and JSON‑RPC tooling.

GDScript Latest v1.14.0 · 16d ago Security brief →

Features

  • Real‑time WebSocket connection for instant feedback without file polling
  • Full access to Godot's editor API, UndoRedo system, and scene tree
  • JSON‑RPC 2.0 protocol with standardized error codes and suggestions
  • Four configurable modes (Full, 3D, Lite, Minimal) matching client tool limits
  • CLI alternative for clients lacking MCP support

Recent releases

View all 16 releases →
Review required
v1.14.0 Breaking risk
Auth Breaking upgrade RCE / SSRF

Dry-run default for cross‑scene writes

No immediate action
v1.13.2 Breaking risk

Port allocation race fix

No immediate action
v1.13.1 Breaking risk

Dead‑connection heartbeat fix

v1.13.0 Bug fix
⚠ Upgrade required
  • `setup` no longer pins `GODOT_MCP_PORT`; client config now allows the server to auto‑scan ports 6505–6509.
Full changelog

v1.13.0 — Bug Fixes & Polish

Fixed

  • simulate_mouse_move honors explicit unhandled: false (#24, #25) — UI drag-and-drop tests can now opt back into normal GUI dispatch by passing unhandled: false explicitly. Auto-promotion for camera-pan drag motions still kicks in when unhandled is omitted.
  • v1.12.0 build blocker — Restored missing utils/load-instructions.ts. Fresh clones of v1.12.0 failed npm run build; v1.13.0 builds clean.

Changed

  • setup no longer pins GODOT_MCP_PORT (#27) — Generated client config omits the env var so the server can auto-scan ports 6505–6509. Pinning caused silent failures when a stale process held the port.
  • Site JSON-LD price → $15 (#26).

Improved

  • README clarity (issue #7 follow-up) — More prominent note that the public repo ships the addon only.
  • build-release.sh portability — Falls back to system zip / python3 when 7-Zip is missing.

Full changelog: https://github.com/youichi-uda/godot-mcp-pro/blob/master/CHANGELOG.md

v1.12.0 New feature
Notable features
  • Added `list_android_devices` wrapper for `adb devices -l`
  • Added `get_android_preset_info` to read Android export preset metadata
  • Added `deploy_to_android` tool to export, install via adb, and launch
Full changelog

Features

  • Android Remote Deploy (#20) — 3 new MCP tools (Full mode):
    • list_android_devicesadb devices -l wrapper
    • get_android_preset_info — reads metadata from Android export preset
    • deploy_to_android — export → adb install -r → launch pipeline

Bug Fixes

  • get_game_user_dir() (#21) — now handles use_custom_user_dir=true and illegal chars in config/name via validate_filename() sanitization, matching Godot's own ProjectSettings::_init logic. Thanks @asim9834 for the detailed repro + patch.

Tool counts

| Mode | Tools |
|------|-------|
| Full | 172 (+3) |
| --3d | 100 (unchanged) |
| --lite | 81 (unchanged) |
| --minimal | 35 (unchanged) |

Full release zip (with MCP server) available on Buy Me a Coffee and itch.io.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
403
Forks
55
Language
GDScript

Install & Platforms

Install via
npm

Beta — feedback welcome: [email protected]