Godot-MCP
Godot-MCP — Model Context Protocol (MCP) integration for the Godot Engine. AI tools for the Godot Editor in C#, with cloud connection to ai-game.dev. Apache-2.0
What is Godot-MCP?
Godot-MCP — Model Context Protocol (MCP) integration for the Godot Engine. AI tools for the Godot Editor in C#, with cloud connection to ai-game.dev. Apache-2.0.
Overview of Godot-MCP
What it is
Godot-MCP is an AI-powered game development assistant for the Godot Engine editor. It integrates the Model Context Protocol (MCP) to allow AI agents such as Claude, Cursor, or Copilot to inspect and control a Godot project. The addon is written in C# and can connect to a cloud backend at ai-game.dev or a self-hosted server. It is the Godot counterpart of Unity-MCP and shares the same MCP/reflection stack via NuGet packages. The project is licensed under Apache-2.0.
Key features
- 23 built-in MCP tools across 9 families for operating the Godot Editor, including RQL (Reflection Query Language) for querying and mutating scenes, nodes, resources, and editor state.
- Supports reading, creating, updating, and deleting both C# (.cs) and GDScript (.gd) scripts, and attaching scripts to nodes.
- Provides visual feedback through viewport, camera, and isolated-node screenshots returned as PNG images.
- Allows calling any Godot method via
CallMethod, including GDScript methods; in a running game, can find and call C# methods via ReflectorNet. - Can connect to the ai-game.dev cloud out of the box or to a custom self-hosted server.
- Includes a CLI tool (
godot-cli) for project scaffolding, plugin installation, login, and MCP configuration.
Use cases
- AI-assisted scene creation and editing, such as generating nodes and arranging them in the scene tree.
- Automated script management, including reading, writing, and attaching scripts to nodes.
- Debugging and inspecting game state during runtime by capturing logs, calling methods, and taking screenshots.
- Rapid prototyping by conversing with an AI agent that can directly manipulate the Godot editor.
Getting started
bash# 1. Install godot-clinpm install -g godot-cli# 2. (Optional) Scaffold a fresh Godot C# projectgodot-cli create-project --dotnet ./MyGodotProject# 3. Install the godot_mcp addongodot-cli install-plugin ./MyGodotProject# 4. Sign in to the ai-game.dev cloudgodot-cli login# 5. Set up MCP config for an AI agent (e.g., Claude Code)godot-cli setup-mcp claude-code ./MyGodotProject# 6. Open the Godot editorgodot-cli open ./MyGodotProject# 7. Wait until the plugin is readygodot-cli wait-for-ready ./MyGodotProject
License and pricing
This project is open source under the Apache-2.0 license. No pricing information is stated.
Based on the project's public README and repository metadata.