Godot MCP

O que é o Godot MCP?

Godot MCP é um plugin para o Godot Engine que atua como uma ponte entre seus projetos Godot e assistentes de IA, utilizando o Protocolo de Contexto do Modelo. Ele permite que ferramentas de IA acessem, analisem e modifiquem scripts, cenas, nós e configurações do projeto diretamente. Isso habilita novos fluxos de trabalho impulsionados por IA para desenvolvimento, depuração e colaboração criativa.

Como Configurar o Godot MCP

• Clone o repositório godot-mcp e acesse seu diretório.
• Construa e configure o servidor MCP executando npm install e npm run build no diretório /server.
• Edite seu arquivo de configuração do Claude Desktop (ex: claude_desktop_config.json) para adicionar uma entrada do servidor MCP apontando para o arquivo de entrada do seu servidor construído.
• Certifique-se de substituir CAMINHO_DO_SEU_PROJETO pelo caminho absoluto do seu repositório clonado.
• Reinicie o Claude Desktop para aplicar as alterações.
• No Godot, abra o projeto de exemplo fornecido ou adicione a pasta addons/godot_mcp ao diretório de addons do seu próprio projeto.
• Ative o plugin em Projeto > Configurações do Projeto > Plugins no Editor Godot.

Como Usar o Godot MCP

Com o servidor MCP em execução e o plugin ativado, interaja com seu projeto Godot através da interface do assistente de IA (ex: Claude Desktop) usando prompts estruturados ou em linguagem natural. Prefacie os comandos com @mcp godot-mcp para enviar pedidos através do servidor MCP. Você pode solicitar sugestões de código, mudanças em cenas, conteúdo gerado por IA e executar comandos de projeto ou recursos diretamente.

Exemplos de Prompts

• @mcp godot-mcp read godot://script/current
  "Preciso de ajuda para otimizar meu código de movimento do jogador. Você pode sugerir melhorias?"
• @mcp godot-mcp run get-scene-tree
  "Adicione um cubo no meio da cena e então faça uma câmera que olhe para o cubo."
• @mcp godot-mcp read godot://scene/current
  "Crie uma IA inimiga que patrulhe entre pontos de referência e ataque o jogador quando estiver ao alcance."

Principais Características

• Comunicação bidirecional sem costura entre Godot e assistentes de IA
• Acesso e modificação programática de recursos do projeto, scripts, cenas e nós
• Conjunto extenso de comandos para gerenciamento de nós, edição de scripts, controle de cena e projeto
• Facilmente extensível com endpoints adicionais de ferramentas MCP
• Configuração segura, local ou remota, com suporte à integração via Claude Desktop
• Assistência impulsionada por IA em linguagem natural para codificação, depuração e criação de cenas

Casos de Uso

• Revisão, geração e refatoração de código impulsionadas por IA para arquivos GDScript
• Criação automatizada de cenas, gerenciamento de nós e geração de ambientes procedurais
• Análise ampla do projeto para otimização de desempenho ou detecção de erros
• Implementação de lógica de jogo, comportamentos de IA e elementos de UI via sugestões de IA
• Edição em lote ou criação de recursos e configurações com orientação de IA
• Aceleração de protótipos, aprendizado ou desenvolvimento colaborativo em projetos Godot

Perguntas Frequentes

Q: O plugin não está funcionando ou não aparece no Godot. O que devo fazer?
A: Certifique-se de que você ativou o plugin "Godot MCP" em Projeto > Configurações do Projeto > Plugins. Se você copiou o addon recentemente ou fez alterações de configuração, tente recarregar o projeto e verificar mensagens de erro no console do Godot.

Q: O Claude Desktop não consegue se conectar ao servidor MCP. O que há de errado?
A: Verifique se o servidor está funcionando corretamente (sem erros na inicialização) e se sua configuração do Claude Desktop possui o caminho absoluto correto. Verifique se MCP_TRANSPORT está definido como stdio. Reinicie o Claude Desktop após atualizar a configuração.

Q: Posso usar o Godot MCP com meus projetos existentes ou apenas com o exemplo incluído?
A: Sim, você pode usá-lo com qualquer projeto Godot. Basta copiar a pasta addons/godot_mcp para o diretório de addons do seu projeto e ativar o plugin nas configurações.

Q: E se eu quiser estender o Godot MCP ou adicionar comandos personalizados?
A: O plugin e o servidor são de código aberto e projetados para extensibilidade. Você pode implementar novos endpoints no servidor MCP ou estender o addon Godot para expor funcionalidades adicionais.

Q: Os dados do meu projeto estão seguros ao usar o Godot MCP?
A: Sim, por padrão o servidor MCP é executado na sua máquina local e só acessa arquivos e dados que você permitir. Revise as configurações do servidor e sempre mantenha as melhores práticas para segurança de dados em mente.