Use This MCP client To

Enable AI-driven NPC behavior scripting in Godot games Automate game testing and debugging via AI commands Integrate real-time AI feedback for game design iteration Control Godot engine features through natural language requests Create AI-powered game assistants or copilots Streamline game development workflows with AI integration

README

🎮 Godot MCP

A plugin that allows external processes to communicate with the Godot engine in a modular and programmable way.

🎥 Watch the video on Twitter (FOLLOW ME PLS PLS)

mcp-demo.mp4

🚀 Getting Started

Follow these steps to get the plugin up and running:

1. Clone the Repository

git clone https://github.com/yourusername/godot-mcp.git
cd Godot-MCP

2. Create a Godot Project

Open Godot Engine

Create a new project or open an existing one

3. Add the Addon to Your Project

Copy the addons/ folder from this repo into your Godot project directory

In the Godot editor, go to Project -> Project Settings -> Plugins and enable the MCP Plugin

4. Set-up your virtual environment

cd python
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

5. Run the MCP Server

python3 server.py
or
python server.py

⚙️ Claude Desktop Integration

To integrate with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "godotMCP": {
      "command": "/Path/To/godot-mcp/venv/bin/python3",
      "args": ["/Path/To/server.py"]
    }
  }
}

RESTART CLAUDE AND HAPPY PROMPTING!!

Godot-MCP FAQ

How do I install the Godot-MCP plugin?

Clone the repository, copy the addons folder into your Godot project, then enable the plugin in Project Settings under Plugins.

What external AI models does Godot-MCP support?

Godot-MCP leverages Claude primarily but can be adapted to work with other LLM providers like OpenAI and Gemini.

How do I run the MCP server for Godot-MCP?

After setting up the Python virtual environment and installing dependencies, run the provided server script to start the MCP server.

Can Godot-MCP handle real-time communication with the Godot engine?

Yes, it supports modular and programmable real-time communication between external AI processes and the Godot engine.

Is Godot-MCP compatible with existing Godot projects?

Yes, you can add the MCP plugin to new or existing Godot projects without disrupting current workflows.

What programming languages are involved in using Godot-MCP?

Godot-MCP uses GDScript for the plugin and Python for the MCP server and AI integration.

Does Godot-MCP support multi-step AI reasoning within the game engine?

Yes, it enables multi-step reasoning by feeding structured context and commands between the AI and Godot engine.