godot-mcp

Godot MCP é um servidor de Protocolo de Contexto de Modelo (MCP) que conecta agentes de IA ao motor de jogo Godot. Ele permite que assistentes de IA interajam diretamente com projetos Godot, iniciando o editor, executando projetos em modo de depuração, capturando saída de console e controlando o fluxo de execução. O servidor também fornece recursos de gerenciamento de cenas, incluindo criação de cenas, adição de nós com propriedades personalizadas, carregamento de sprites, exportação de cenas 3D como recursos MeshLibrary e gerenciamento de referências UID para Godot 4.4+. ## Recursos Principais - **Controle de Editor e Projeto**: Inicie o editor Godot, execute projetos em modo de depuração e pare-os programaticamente - **Captura de Saída de Depuração**: Recupere saída de console e mensagens de erro para feedback em tempo real - **Análise de Projeto**: Liste projetos em um diretório, obtenha informações detalhadas da estrutura do projeto e recupere a versão instalada do Godot - **Gerenciamento de Cenas**: - Crie novas cenas com tipos de nó raiz especificados - Adicione nós a cenas existentes com propriedades personalizáveis - Carregue sprites/texturas em nós Sprite2D - Exporte cenas 3D como recursos MeshLibrary para GridMap - Salve cenas com opções de variantes - **Gerenciamento de UID** (Godot 4.4+): Obtenha UIDs para arquivos e atualize referências de UID re-salvando recursos ## Arquitetura O servidor usa uma abordagem híbrida: 1. **Comandos Diretos**: Operações simples (iniciar editor, obter versão) usam comandos CLI integrados do Godot 2. **Script de Operações Empacotado**: Operações complexas (criação de cenas, manipulação de nós) usam um único arquivo GDScript abrangente (`godot_operations.gd`) que aceita tipo de operação e parâmetros como JSON, permitindo execução flexível sem gerar arquivos temporários ## Requisitos - Motor Godot instalado - Node.js (>=18.0.0) e npm - Um agente de IA compatível com MCP (ex.: Claude Code, Cursor) ## Início Rápido Para Claude Code: bash claude mcp add godot -- npx @coding-solo/godot-mcp Para Cursor, adicione o servidor MCP nas configurações com o comando `npx @coding-solo/godot-mcp`. ## Configuração Variáveis de ambiente: - `GODOT_PATH`: Caminho para o executável do Godot (substitui a detecção automática) - `DEBUG`: Defina como `"true"` para registro detalhado no lado do servidor ## Solução de Problemas - **Godot Não Encontrado**: Defina a variável de ambiente `GODOT_PATH` - **Problemas de Conexão**: Garanta que o servidor esteja em execução e reinicie seu assistente de IA - **Caminho de Projeto Inválido**: Garanta que o caminho contenha um arquivo `project.godot` - **Problemas de Build**: Execute `npm install` para instalar dependências ## Licença Licença MIT