Um servidor MCP para interagir com o motor de jogo Godot. Fornece ferramentas para iniciar o editor, executar projetos e capturar a saída de depuração.

📚 Introdução ao Projeto Godot MCP

I. Visão Geral do Projeto

Godot MCP (Servidor de Protocolo de Contexto de Modelo) publicado por Coding‑Solo, é uma ferramenta que faz a ponte entre assistentes de IA e o motor Godot. Através do protocolo MCP, ele pode iniciar o editor Godot, executar projetos, capturar informações de depuração e ter controle profundo sobre a estrutura do projeto e as cenas.

Este mecanismo fornece um ciclo de feedback real para assistentes de IA (como Claude, Cline, Cursor), permitindo que eles operem projetos na prática, depurem problemas e gerem código GDScript de alta qualidade.

---

II. Funcionalidades e Características Principais

1. Iniciar o Editor e Executar Projetos Suporta através da linha de comando:

   • Iniciar o editor Godot no caminho especificado
   • Executar o projeto em modo de depuração
   • Capturar e retornar a saída do console ou informações de erro

2. Obtenção e Análise da Estrutura do Projeto

   • Obter a versão do projeto, a estrutura de diretórios e a lista de recursos
   • Aprofundar-se nas informações da estrutura da cena, incluindo a árvore de nós, atributos, caminhos de recursos, etc.

3. Gerenciamento de Cenas e Nós

   • Criar novas cenas (especificando o tipo de nó raiz)
   • Adicionar nós a cenas existentes e definir atributos
   • Carregar texturas Sprite2D, exportar MeshLibrary para GridMap
   • Salvar cenas e suportar a geração de variantes de cena

4. Depuração e Gerenciamento de Versões

   • Parar o projeto em execução
   • Obter e exibir a versão do motor Godot
   • (Aplicável ao Godot 4.4+) Obter o UID do arquivo e atualizar as referências de recursos

5. Compatível com Várias Ferramentas de Assistência de IA

   • Suporta Cline e Cursor: integrar ferramentas de assistente de IA através de arquivos de configuração MCP e linha de comando

---

III. Arquitetura e Destaques da Implementação

• Único "Script de Operações" GDScript Todos os comandos complexos (como criar nós, exportar cenas, etc.) são gerenciados por um único godot_operations.gd, evitando a geração de scripts temporários individuais, garantindo simplicidade e eficiência, e reduzindo a E/S de disco e a possibilidade de erros.

• Mecanismo Combinado de CLI e Script Comandos simples diretamente através da CLI do Godot, operações complexas através de scripts GDScript, ambos transmitindo instruções JSON padrão MCP, estrutura unificada, fácil de expandir.

• Estrutura de Resposta Padronizada Todas as operações retornam um formato unificado: status, conteúdo do resultado, saída padrão/erro, facilitando a análise, o aprendizado e a geração automática de sugestões de alteração pela IA.

---

IV. Fluxo de Uso

1. Instalação e Construção

   git clone https://github.com/Coding-Solo/godot-mcp.git
   cd godot-mcp
   npm install
   npm run build
   

2. Configuração da Ferramenta de IA

   • Cline: Adicione a configuração do servidor correspondente em cline_mcp_settings.json
   • Cursor: Adicione a instrução node através de Settings → Features → MCP

3. Execução e Interação

   • Exemplos de instruções de IA:

     • launch_editor: Iniciar o editor
     • run_project: Executar o projeto e obter a saída
     • create_scene / add_node: Criar cena/nó
     • get_debug_output / stop_project: Instruções de controle de depuração
     • get_uid / update_project_uids: Gerenciamento de UID

---

V. Resumo dos Destaques do Projeto

Vantagem	Descrição
🌟 Alta Automação	Assistente de IA controla diretamente o editor/projeto, sem intervenção manual
🚫 Sem Arquivos Temporários	Usa uma única entrada GDScript, leve e eficiente
♻️ Suporte a Versão & UID	Compatível com recursos do Godot 4.4+, pode gerenciar UIDs de recursos
🛠️ Fácil de Expandir & Integrar	O padrão MCP facilita a adição de novos recursos, compatível com várias ferramentas de IA

---

VI. Conclusão 🌈

Godot MCP é uma ferramenta poderosa e prática que constrói uma ponte entre assistentes de IA e o motor Godot. A IA pode diretamente:

• Iniciar o editor, executar projetos, coletar dados;
• Acessar a estrutura do projeto, scripts, cenas, recursos;
• Modificar dinamicamente cenas, nós, scripts;
• Realizar depuração, gerar sugestões de código GDScript.

Com um protocolo unificado e scripts de operação GDScript, ele fornece uma interface de automação clara, padronizada e expansível. Para desenvolvedores de jogos, é uma ferramenta para aumentar a eficiência e os processos de desenvolvimento inteligentes.