Godot-MCP

# 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 ```