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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ivanmurzakgodot-mcp.svg)](https://yunodb.com/tools/ivanmurzakgodot-mcp?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ivanmurzakgodot-mcp?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ivanmurzakgodot-mcp.svg" alt="Featured on YunoDB" height="20"></a>