Overview
What is Godot MCP?
Godot MCP is a Model Context Protocol server that enables AI agents to launch the Godot editor, run projects, capture debug output, and control project execution. It is designed for developers using AI assistants with Godot game engine projects.
How to use Godot MCP?
Install via npx @coding-solo/godot-mcp and configure your MCP client (Claude Code, Cline, Cursor, or any MCP‑compatible client). Set the GODOT_PATH environment variable if Godot is not automatically detected.
Key features of Godot MCP
- Launch the Godot editor for a specific project
- Run Godot projects in debug mode and capture console output
- Control project execution (start and stop programmatically)
- Retrieve the installed Godot version and list Godot projects
- Create scenes, add nodes, load sprites, and export MeshLibrary resources
- Manage UIDs for files (Godot 4.4+) and update UID references
Use cases of Godot MCP
- AI‑assisted game development with real‑time feedback from Godot
- Automated testing of Godot projects via debug output capture
- Programmatic scene creation and node manipulation
- Batch UID updates across a Godot project
FAQ from Godot MCP
What does Godot MCP do?
It allows an AI agent to control the Godot engine—launch the editor, run projects, capture debug logs, and perform scene management—creating a direct feedback loop for better code generation.
What are the requirements for Godot MCP?
You need Godot Engine installed, Node.js (>=18.0.0) and npm, and an AI agent that supports the Model Context Protocol.
How do I install Godot MCP?
Run npx @coding-solo/godot-mcp with your MCP client. For example, in Claude Code: claude mcp add godot -- npx @coding-solo/godot-mcp. Optionally set GODOT_PATH or DEBUG environment variables.
How do I troubleshoot if Godot is not found?
Set the GODOT_PATH environment variable to the full path of your Godot executable. Ensure the path points to a directory containing a project.godot file when running a project.
Does Godot MCP support Godot 4.4+ UID features?
Yes. Godot MCP includes UID management tools: get_uid to retrieve a file’s UID and update_project_uids to resave resources and update UID references.
