Godot MCP

Um plugin para comunicação modular entre processos externos e o motor de jogos Godot.

Documentação

Servidor Godot MCP

Um servidor Model Context Protocol (MCP) que permite ao Claude Desktop controlar e interagir com o editor do Godot Engine.

VÍDEO DE DEMONSTRAÇÃO

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

NOVA ATUALIZAÇÃO!!!! ADICIONADA INTEGRAÇÃO COM A API MESHY

GERE CENAS DINÂMICAS CHAMANDO A API MESHY, IMPORTADAS DIRETAMENTE PARA O GODOT

Instruções de Configuração

Pré-requisitos

Godot Engine (4.x ou posterior)
Python 3.8+
Aplicativo Claude Desktop
Conta na API Meshy (opcional, para malhas geradas por IA)

PASSO 0: Clone o repositório e navegue até o diretório

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

Passo 1: Instalar o Plugin do Godot

Copie a pasta addons/godot_mcp/ para o diretório addons/ do seu projeto Godot
Abra seu projeto Godot
Vá para Project → Project Settings → Plugins
Ative o plugin "Godot MCP"
Você deve ver um painel "MCP" aparecer na parte inferior do editor
O plugin automaticamente começa a escutar em uma porta

Passo 2: Configurar o Ambiente Python

Navegue até o diretório python/:
```
cd python
```

Crie e ative um ambiente virtual:

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

Instale as dependências:
```
pip install -r ../requirements.txt
```

Passo 3: Configurar o Claude Desktop

Localize o arquivo de configuração do Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione a configuração do 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": {}
    }
  }
}

Substitua /path/to/your/godot-mcp/python/server.py pelo caminho real para o seu arquivo server.py.

Reinicie o Claude Desktop e aproveite os prompts!

OPCIONAL: Configurar a API Meshy

Cadastre-se para uma conta na API Meshy em https://www.meshy.ai/
Obtenha sua chave de API no painel (formato: msy-<random-string>)

Configure sua chave de API usando um destes métodos:

Opção A: Usando arquivo .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

Em seguida, adicione sua chave ao arquivo .env:

MESHY_API_KEY=your_actual_api_key_here