Repolode
Submit
Coding-Solo

Coding-Solo/godot-mcp

An MCP server that lets AI agents launch the Godot editor, run projects, capture debug output, and manage scenes.

View on GitHub
Stars
6,154
Forks
490
Open issues
75
Last commit
6 months ago

What is it?

Godot MCP is a Model Context Protocol server that connects AI agents to the Godot game engine. It lets an agent open the Godot editor for a project, run the project in debug mode, start and stop it, and read the console output and error messages it produces. With that feedback loop, an agent can see what actually works in a Godot project and use the errors to fix its code.

Beyond running projects, the server can list Godot projects in a directory, report project structure, and report the installed Godot version. It can also create scenes with a chosen root node type, add nodes with custom properties, load sprites and textures into Sprite2D nodes, export 3D scenes as MeshLibrary resources for GridMap, and save scenes as variants. For Godot 4.4 and later, it can get UIDs for files and update UID references by resaving resources.

Simple operations call Godot's built-in CLI directly, while more complex scene edits go through a single bundled GDScript file that takes JSON parameters. The server runs on Node.js 18 or newer and is set up with a single npx command for clients such as Claude Code, Cline, and Cursor.

Key features

  • 01Launches the Godot editor for a specified project.
  • 02Runs projects in debug mode and captures console output and errors.
  • 03Starts and stops projects programmatically.
  • 04Creates scenes, adds nodes with custom properties, and saves scene variants.
  • 05Exports 3D scenes as MeshLibrary resources for GridMap.
  • 06Gets and updates UIDs for Godot 4.4+ projects.

Use cases

  • Letting an AI coding assistant test and debug a Godot game by running it and reading the errors.
  • Generating scene structures and nodes for a Godot project through an AI agent.
  • Automating project setup tasks such as listing projects and checking the Godot version.

Quick start

  1. 1

    Install Godot Engine on your system

  2. 2

    Add the MCP server to Claude Code

    claude mcp add godot -- npx @coding-solo/godot-mcp
  3. 3

    Restart Claude Code to use the Godot MCP tools

Things to know

  • Requires Godot Engine to be installed locally.
  • UID management features need Godot 4.4 or newer.

Topics

#game-development#godot#model-context-protocol#game-engine#ai-agent#nodejs#ai#mcp

FAQ

What is godot-mcp?
An MCP server that lets AI agents launch the Godot editor, run projects, capture debug output, and manage scenes. Godot MCP is a Model Context Protocol server that connects AI agents to the Godot game engine. It lets an agent open the Godot editor for a project, run the project in debug mode, start and stop it, and read the console output and error messages it produces. With that feedback loop, an agent can see what actually works in a Godot project and use the errors to fix its code.
Is godot-mcp free to use? What license does it have?
godot-mcp is open source under the MIT license. Check the license terms before using it in commercial products.
Is godot-mcp still maintained?
No commits for 6+ months. The last commit to godot-mcp was on Apr 16, 2026.
What can I use godot-mcp for?
Letting an AI coding assistant test and debug a Godot game by running it and reading the errors. Generating scene structures and nodes for a Godot project through an AI agent. Automating project setup tasks such as listing projects and checking the Godot version.
How do I install godot-mcp?
Install Godot Engine on your system Add the MCP server to Claude Code: claude mcp add godot -- npx @coding-solo/godot-mcp Restart Claude Code to use the Godot MCP tools
Where can I get godot-mcp?
The source code and installation instructions are on GitHub: https://github.com/Coding-Solo/godot-mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects