Repolode
Enviar
Coding-Solo

Coding-Solo/godot-mcp

Servidor MCP que permite a agentes de IA abrir o editor Godot, executar projetos, capturar logs de depuração e gerenciar cenas.

Ver no GitHub
Estrelas
6,154
Forks
490
Issues abertas
75
Último commit
há 6 meses

O que é?

Godot MCP é um servidor Model Context Protocol que conecta agentes de IA ao motor de jogos Godot. Ele permite que um agente abra o editor Godot para um projeto, execute o projeto no modo de depuração, inicie e encerre sua execução e leia a saída do console e as mensagens de erro geradas. Com esse ciclo de feedback, o agente consegue verificar o que realmente funciona em um projeto Godot e usar os erros para corrigir o código.

Além de executar projetos, o servidor pode listar projetos Godot em um diretório, informar a estrutura do projeto e a versão instalada do Godot. Ele também pode criar cenas com um tipo de nó raiz escolhido, adicionar nós com propriedades personalizadas, carregar sprites e texturas em nós Sprite2D, exportar cenas 3D como recursos MeshLibrary para GridMap e salvar cenas como variantes. No Godot 4.4 ou posterior, ele pode obter UIDs de arquivos e atualizar referências a UIDs salvando os recursos novamente.

Operações simples chamam diretamente a CLI integrada do Godot, enquanto edições de cena mais complexas são feitas por meio de um único arquivo GDScript incluído no pacote, que recebe parâmetros JSON. O servidor requer Node.js 18 ou posterior e pode ser configurado com um único comando npx em clientes como Claude Code, Cline e Cursor.

Recursos principais

  • 01Abre o editor Godot para o projeto especificado.
  • 02Executa projetos no modo de depuração e captura a saída do console e os erros.
  • 03Inicia e encerra projetos programaticamente.
  • 04Cria cenas, adiciona nós com propriedades personalizadas e salva variantes de cenas.
  • 05Exporta cenas 3D como recursos MeshLibrary para GridMap.
  • 06Obtém e atualiza UIDs em projetos Godot 4.4 ou posterior.

Casos de uso

  • Permitir que um assistente de programação com IA teste e depure um jogo Godot executando-o e lendo os erros.
  • Gerar estruturas de cenas e nós para um projeto Godot por meio de um agente de IA.
  • Automatizar tarefas de configuração do projeto, como listar projetos e verificar a versão do Godot.

Início rápido

  1. 1

    Instale o Godot Engine no seu sistema

  2. 2

    Adicione o servidor MCP ao Claude Code

    claude mcp add godot -- npx @coding-solo/godot-mcp
  3. 3

    Reinicie o Claude Code para usar as ferramentas MCP do Godot

Antes de usar

  • O Godot Engine precisa estar instalado localmente.
  • Os recursos de gerenciamento de UID precisam do Godot 4.4 ou mais recente.

Tópicos

#game-development#godot#model-context-protocol#game-engine#ai-agent#nodejs#ai#mcp

Perguntas frequentes

O que é godot-mcp?
Servidor MCP que permite a agentes de IA abrir o editor Godot, executar projetos, capturar logs de depuração e gerenciar cenas. Godot MCP é um servidor Model Context Protocol que conecta agentes de IA ao motor de jogos Godot. Ele permite que um agente abra o editor Godot para um projeto, execute o projeto no modo de depuração, inicie e encerre sua execução e leia a saída do console e as mensagens de erro geradas. Com esse ciclo de feedback, o agente consegue verificar o que realmente funciona em um projeto Godot e usar os erros para corrigir o código.
godot-mcp é gratuito? Qual é a licença?
godot-mcp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
godot-mcp ainda é mantido?
Sem commits há mais de 6 meses. O último commit de godot-mcp foi em 16 de abr. de 2026.
Para que posso usar godot-mcp?
Permitir que um assistente de programação com IA teste e depure um jogo Godot executando-o e lendo os erros. Gerar estruturas de cenas e nós para um projeto Godot por meio de um agente de IA. Automatizar tarefas de configuração do projeto, como listar projetos e verificar a versão do Godot.
Como instalar godot-mcp?
Instale o Godot Engine no seu sistema Adicione o servidor MCP ao Claude Code: claude mcp add godot -- npx @coding-solo/godot-mcp Reinicie o Claude Code para usar as ferramentas MCP do Godot
Onde consigo godot-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Coding-Solo/godot-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados