Godot MCP

Un complemento para la comunicación modular entre procesos externos y el motor de juegos Godot.

Documentación

Servidor Godot MCP

Un servidor de Model Context Protocol (MCP) que permite a Claude Desktop controlar e interactuar con el editor de Godot Engine.

VIDEO DE DEMOSTRACIÓN

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

¡¡¡NUEVA ACTUALIZACIÓN!!!! INTEGRACIÓN DE LA API DE MESHY AÑADIDA

GENERA ESCENAS DINÁMICAS LLAMANDO A LA API DE MESHY, IMPORTADAS DIRECTAMENTE EN GODOT

Instrucciones de Configuración

Requisitos Previos

Godot Engine (4.x o posterior)
Python 3.8+
Aplicación Claude Desktop
Cuenta de API de Meshy (opcional, para mallas generadas por IA)

PASO 0: Clona el repositorio y navega al directorio

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

Paso 1: Instalar el Plugin de Godot

Copia la carpeta addons/godot_mcp/ al directorio addons/ de tu proyecto de Godot
Abre tu proyecto de Godot
Ve a Project → Project Settings → Plugins
Habilita el plugin "Godot MCP"
Deberías ver un panel "MCP" aparecer en la parte inferior del editor
El plugin automáticamente comienza a escuchar en un puerto

Paso 2: Configurar el Entorno de Python

Navega al directorio python/:
```
cd python
```

Crea y activa un entorno virtual:

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

Instala las dependencias:
```
pip install -r ../requirements.txt
```

Paso 3: Configurar Claude Desktop

Localiza tu archivo de configuración de Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade la configuración del servidor Godot MCP:

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

Reemplaza /path/to/your/godot-mcp/python/server.py con la ruta real a tu archivo server.py.

Reinicia Claude Desktop y ¡feliz prompting!

OPCIONAL: Configurar la API de Meshy

Regístrate para obtener una cuenta de API de Meshy en https://www.meshy.ai/
Obtén tu clave de API desde el panel de control (formato: msy-<random-string>)

Configura tu clave de API usando uno de estos métodos:

Opción A: Usando el archivo .env (Recomendado)

# 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

Luego añade tu clave al archivo .env:

MESHY_API_KEY=your_actual_api_key_here