Godot MCP logo

Godot MCP

by Coding-Solo

Godot MCP is a Model Context Protocol server that enables AI assistants to interact with the Godot game engine. It allows AI to launch the editor, run projects, capture debug output, and control project execution through a standardized interface.

View on GitHub

Last updated: N/A

What is Godot MCP?

Godot MCP is a server that implements the Model Context Protocol (MCP) to provide a standardized interface for AI assistants to interact with the Godot game engine. It allows AI tools to automate tasks, debug code, and understand project structure within the Godot environment.

How to use Godot MCP?

To use Godot MCP, you need to install and configure the server, then configure your AI assistant (like Cline or Cursor) to connect to it. This involves cloning the repository, installing dependencies, building the server, and adding the server configuration to your AI assistant's settings. Once configured, you can use prompts to instruct your AI assistant to perform tasks within the Godot editor.

Key features of Godot MCP

  • Launch Godot Editor

  • Run Godot Projects

  • Capture Debug Output

  • Control Execution

  • Get Godot Version

  • Project Analysis

  • Scene Management

  • UID Management (Godot 4.4+)

Use cases of Godot MCP

  • Automated code generation and debugging

  • Project structure analysis and improvement suggestions

  • Automated scene creation and modification

  • Integration of AI-powered tools into the Godot development workflow

FAQ from Godot MCP

How do I resolve 'Godot Not Found' errors?

Set the GODOT_PATH environment variable to the location of your Godot executable.

What should I do if I encounter connection issues?

Ensure the server is running and restart your AI assistant.

What causes 'Invalid Project Path' errors?

Ensure the path points to a directory containing a project.godot file.

How do I fix build issues?

Make sure all dependencies are installed by running npm install in the project directory.

Why isn't the MCP server showing up in Cursor?

Ensure the MCP server is enabled in Cursor settings (Settings > MCP). Also, MCP tools can only be run using the Agent chat profile (Cursor Pro or Business subscription). Try using 'Yolo Mode' to automatically run MCP tool requests.