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

Launch Godot editor for a specific project

Run the Godot project and capture output

Get the current debug output and errors

Stop the currently running Godot project

Get the installed Godot version

List Godot projects in a directory

Retrieve metadata about a Godot project

Create a new Godot scene file

Add a node to an existing scene

Load a sprite into a Sprite2D node

Export a scene as a MeshLibrary resource

Save changes to a scene file

Get the UID for a specific file in a Godot project (for Godot 4.4+)

Update UID references in a Godot project by resaving resources (for Godot 4.4+)

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.

Comments

Basic information

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.