# 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

<img width="324" height="331" alt="Screenshot 2025-07-14 at 9 07 13 PM" src="https://github.com/user-attachments/assets/f907d709-8f09-46b7-a70e-754b4f4cbbf1" />

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

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

```




### Step 1: Install Godot Plugin

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

### Step 2: Set up Python Environment

1. Navigate to the `python/` directory:
   ```bash
   cd python
   ```

2. Create and activate a virtual environment:
   ```bash
   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   ```

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

### Step 3: Configure Claude Desktop

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

2. Add the Godot MCP server configuration:
   ```json
   {
     "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.

3. Restart Claude Desktop and happy prompting!

### OPTIONAL: Set up Meshy API

1. Sign up for a Meshy API account at [https://www.meshy.ai/](https://www.meshy.ai/)
2. Get your API key from the dashboard (format: `msy-<random-string>`)
3. Set up your API key using one of these methods:

   **Option A: Using .env file (Recommended)**
   ```bash
   # 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
   ```