← all repositories
Coding-Solo/godot-mcp

Your AI just learned to drive Godot

An MCP server that lets AI agents actually run, debug, and manipulate Godot projects instead of just guessing at GDScript syntax.

4.9k stars JavaScript Coding Assistants
godot-mcp
Velocity · 7d
+18
★ / day
Trend
accelerating
star history

What it does

Godot MCP is a bridge server that exposes the Godot game engine to AI agents through the Model Context Protocol. It can launch the editor, run projects in debug mode, capture console output, and perform scene operations like adding nodes or loading sprites. The agent gets real feedback from a live engine rather than hallucinating what might work.

The interesting bit

Complex operations use a single bundled GDScript file (godot_operations.gd) that accepts JSON parameters, avoiding the mess of generating temporary scripts for every command. Simple tasks hit Godot’s CLI directly. It’s a pragmatic split: CLI where possible, embedded script where necessary.

Key highlights

  • Launches editor, runs projects, and captures debug output programmatically
  • Scene management: create scenes, add nodes with properties, load textures, export MeshLibrary resources
  • UID management for Godot 4.4+ file references
  • Auto-detects Godot executable or accepts GODOT_PATH override
  • Supports Claude Code, Cline, Cursor, and other MCP clients

Caveats

  • Requires local Godot and Node.js installation; not a remote/cloud solution
  • Cursor users need Pro/Business subscription for Agent chat profile to use MCP tools
  • Scene manipulation coverage is broad but not exhaustive; complex editor workflows may still need human hands

Verdict

Worth a look if you’re building AI-assisted Godot workflows and tired of the “write code, pray it compiles” loop. Skip it if you don’t use Godot or your AI tooling doesn’t support MCP yet.

Frequently asked

What is Coding-Solo/godot-mcp?
An MCP server that lets AI agents actually run, debug, and manipulate Godot projects instead of just guessing at GDScript syntax.
Is godot-mcp open source?
Yes — Coding-Solo/godot-mcp is open source, released under the MIT license.
What language is godot-mcp written in?
Coding-Solo/godot-mcp is primarily written in JavaScript.
How popular is godot-mcp?
Coding-Solo/godot-mcp has 4.9k stars on GitHub and is currently accelerating.
Where can I find godot-mcp?
Coding-Solo/godot-mcp is on GitHub at https://github.com/Coding-Solo/godot-mcp.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.