Godot MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to control and interact with the Godot Engine editor.

DEMO VIDEO

https://github.com/user-attachments/assets/07424399-31b5-47ee-a20d-808b2e789731

NEW UPDATE!!!! ADDED MESHY API INTEGRATION

GENERATE DYNAMIC SCENES BY CALLING THE MESHY API, DIRECTLY IMPORTED INTO GODOT

Setup Instructions

Prerequisites

Godot Engine (4.x or later)
Python 3.8+
Claude Desktop app
Meshy API account (optional, for AI-generated meshes)

STEP 0: Clone the repo and navigate to the directory

git clone https://github.com/Dokujaa/Godot-MCP.git

Step 1: Install Godot Plugin

Copy the addons/godot_mcp/ folder to your Godot project's addons/ directory
Open your Godot project
Go to Project → Project Settings → Plugins
Enable the "Godot MCP" plugin
You should see an "MCP" panel appear at the bottom of the editor
The plugin automatically starts listening on a port

Step 2: Set up Python Environment

Navigate to the python/ directory:
```
cd python
```

Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies:
```
pip install -r ../requirements.txt
```

Step 3: Configure Claude Desktop

Locate your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Godot MCP server configuration:

{
  "mcpServers": {
    "godot": {
      "command": "/path/to/your/godot-mcp/python/venv/bin/python",
      "args": ["/path/to/your/godot-mcp/python/server.py"],
      "env": {}
    }
  }
}

Replace /path/to/your/godot-mcp/python/server.py with the actual path to your server.py file.

Restart Claude Desktop and happy prompting!

OPTIONAL: Set up Meshy API

Sign up for a Meshy API account at https://www.meshy.ai/
Get your API key from the dashboard (format: msy-<random-string>)

Set up your API key using one of these methods:

Option A: Using .env file (Recommended)

# Copy the example file
cp python/.env.example python/.env

# Edit the .env file and add your API key
nano python/.env  # or use your preferred editor

Then add your key to the .env file:

MESHY_API_KEY=your_actual_api_key_here

Setup Instructions

Prerequisites

Godot Engine (4.x or later)

Python 3.8+

Claude Desktop app

Meshy API account (optional, for AI-generated meshes)

STEP 0: Clone the repo and navigate to the directory

git clone https://github.com/Dokujaa/Godot-MCP.git

Step 1: Install Godot Plugin

Copy the addons/godot_mcp/ folder to your Godot project's addons/ directory

Open your Godot project

Go to Project → Project Settings → Plugins

Enable the "Godot MCP" plugin

You should see an "MCP" panel appear at the bottom of the editor

The plugin automatically starts listening on a port

Step 2: Set up Python Environment

Navigate to the python/ directory:

cd python

Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies:

pip install -r ../requirements.txt