Godot MCP

@Coding-Solo

About Godot MCP

MCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.

#ai #mcp #godot

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": [
        "@coding-solo/godot-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.

Frequently asked questions

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.