better-godot-mcp

Integração do Godot Engine: 17 ferramentas para desenvolvimento de jogos

Documentação

Better Godot MCP

mcp-name: io.github.n24q02m/better-godot-mcp

Servidor MCP composto para Godot Engine -- 17 ferramentas compostas para desenvolvimento de jogos assistido por IA.

Projetos irmãos de n24q02m (clique para expandir)

Projeto	Tagline	Tag
agent-chat-plugin	Agentes de IA pares conversam em uma pasta compartilhada — sem relay humano, sem orquestrador, funci...	Tooling
better-code-review-graph	Grafo de conhecimento para revisões de código eficientes em tokens -- busca semântica e cha...	MCP
better-drive	Sincronização bidirecional do Google Drive com filtro .driveignore — mecanismo rclone, bandeja do Windows	Tooling
better-email-mcp	E-mail IMAP/SMTP para agentes de IA -- ler, enviar, organizar pastas e gerenciar ane...	MCP
better-godot-mcp	Servidor MCP composto para Godot Engine -- 17 ferramentas compostas para desenvolvimento de jogos assistido por...	MCP
better-notion-mcp	Notion com foco em Markdown para agentes de IA -- páginas, bancos de dados, blocos e comentá...	MCP
better-semantic-release	Fork drop-in do python-semantic-release com proteções de segurança de release integradas (orp...	Tooling
better-telegram-mcp	Telegram para agentes de IA -- mensagens, chats, mídia e contatos em ambos os...	MCP
better-workspace-mcp	Servidor MCP do Google Workspace (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch...	MCP
claude-plugins	Marketplace de plugins do Claude Code para os servidores MCP n24q02m -- instale busca web...	Marketplace
imagine-mcp	Compreensão de imagem e vídeo + geração para agentes de IA -- em Gemini, Op...	MCP
jules-task-archiver	Extensão do Chrome para operações em lote em tarefas do Jules via API batchexecute -- a...	Tooling
mcp-core	Base compartilhada para construir servidores MCP -- transporte Streamable HTTP, OAut...	MCP
mnemo-mcp	Memória de IA persistente com busca híbrida e sincronização incorporada. Aberta, gratuita, ilimi...	MCP
qwen3-embed	Embedding de texto Qwen3 leve e reordenação via ONNX Runtime e GGUF	Library
skret	Segredos sem o servidor.	CLI
tacet	Uma cascata neuro-simbólica autodestilante que amortiza o custo de LLM em conheci...	Tooling
web-core	Pacote de infraestrutura web compartilhada para busca, scraping, segurança HTTP e st...	Library
wet-mcp	Servidor MCP de código aberto para agentes de IA: busca web, extração de conteúdo e lib...	MCP

Recursos

17 mega-ferramentas compostas -- cena, nó, script, shader, animação, tilemap, física, áudio, navegação, UI e mais
Controle total de cena -- crie, analise e modifique arquivos .tscn diretamente sem o Godot em execução
CRUD de GDScript -- crie, leia, escreva e anexe scripts em uma única chamada
Otimização de tokens em camadas -- descrições compactadas + ferramenta help sob demanda

Instalação

Executa via stdio por padrão. Sem credenciais, sem conta, sem relay -- o servidor lê e grava diretamente os arquivos locais do seu projeto Godot. Godot 4.x é opcional para operações de arquivo; apenas ações de run/stop/export e editor precisam de um binário do Godot. O detector aceita Godot >=4.1. A compatibilidade com o motor em tempo real é atualmente verificada com Godot 4.7.1 estável; isso não afirma que todas as futuras versões menores foram verificadas.

Via npx (recomendado)

npx -y @n24q02m/better-godot-mcp@latest

Configuração do cliente MCP

Adicione à configuração MCP do seu cliente (Claude Code, Cursor, Windsurf, Codex, mcp.json):

{
  "mcpServers": {
    "better-godot-mcp": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-godot-mcp"],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

GODOT_PROJECT_PATH é opcional -- toda ferramenta também aceita um argumento project_path por chamada.

Via Docker

docker run -i --rm -v /path/to/your/godot/project:/project n24q02m/better-godot-mcp

A imagem é publicada para amd64 e arm64. Monte o diretório do seu projeto para que o servidor possa ler e gravar arquivos de cena, script e recursos.

Smithery

better-godot-mcp inclui um smithery.yaml para que possa ser descoberto e implantado através do Smithery. O Smithery inicia o servidor via stdio através de npx -y @n24q02m/better-godot-mcp, e nenhuma configuração é necessária para iniciar -- o servidor não tem credenciais e lê diretamente os arquivos locais do seu projeto Godot.

Documentação

Guia completo de configuração em mcp.n24q02m.com/servers/better-godot-mcp/setup/ -- etapas de instalação para Claude Code, Codex, Gemini CLI, Cursor, Windsurf e mcp.json.

Instale com agente de IA -- cole isto no seu agente de codificação de IA:

Instale o servidor MCP better-godot-mcp seguindo as etapas em https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.md

Ferramentas

Ferramenta	Ações	Descrição
`project`	`info`, `version`, `run`, `stop`, `settings_get`, `settings_set`, `export`	Metadados do projeto, executar/parar e configurações
`scenes`	`create`, `list`, `info`, `delete`, `duplicate`, `set_main`	Gerenciamento de arquivos de cena
`nodes`	`add`, `remove`, `rename`, `list`, `set_property`, `get_property`	Manipulação de nós da árvore de cena
`scripts`	`create`, `read`, `write`, `attach`, `list`, `delete`	CRUD de arquivos GDScript
`editor`	`launch`, `status`	Iniciar o editor Godot e verificar o status
`config`	`status`, `set`, `detect_godot`, `check`	Configuração do servidor e detecção de ambiente
`resources`	`list`, `info`, `delete`, `import_config`	Gerenciamento de arquivos de recursos
`input_map`	`list`, `add_action`, `remove_action`, `add_event`	Mapeamento de ações de entrada e eventos
`signals`	`list`, `connect`, `disconnect`	Conexões de sinais
`animation`	`create_player`, `add_animation`, `add_track`, `add_keyframe`, `list`	Players de animação e trilhas
`tilemap`	`create_tileset`, `add_source`, `set_tile`, `paint`, `list`	Gerenciamento de TileMap e TileSet
`shader`	`create`, `read`, `write`, `get_params`, `list`	CRUD de arquivos de shader com sintaxe Godot 4
`physics`	`layers`, `collision_setup`, `body_config`, `set_layer_name`	Camadas de colisão e corpos de física
`audio`	`list_buses`, `add_bus`, `add_effect`, `create_stream`	Gerenciamento de barramentos de áudio e efeitos
`navigation`	`create_region`, `add_agent`, `add_obstacle`	Regiões de navegação, agentes e obstáculos
`ui`	`create_control`, `set_theme`, `layout`, `list_controls`	Criação de controles de UI e temas
`help`	-	Obter documentação completa para qualquer ferramenta

Comparação

Como o better-godot-mcp se compara aos concorrentes diretos em cada pilar:

Capacidade	better-godot-mcp	Coding-Solo/godot-mcp	bradypp/godot-mcp	tugcantopaloglu/godot-mcp
Gerenciamento de arquivos de cena	Sim (`scenes`: criar/listar/info/excluir/duplicar/set_main)	Sim (criar/salvar)	Sim (criar/salvar)	Sim (criar/ler/modificar)
Manipulação da árvore de nós	Sim (`nodes`: adicionar/remover/renomear/listar/get+set_property)	Parcial (apenas adicionar)	Sim (adicionar/editar/remover)	Sim (adicionar/remover/reparentar)
CRUD de arquivos GDScript	Sim (`scripts`: criar/ler/escrever/anexar/listar/excluir)	Não	Não	Parcial (criar a partir de modelo + avaliação em tempo de execução)
CRUD de arquivos de shader	Sim (`shader`: criar/ler/escrever/get_params/listar)	Não	Não	Parcial (criar/ler .gdshader)
Criação de animações	Sim (`animation`: player/track/keyframe)	Não	Não	Sim (player/tween/máquina de estados)
TileMap / TileSet	Sim (`tilemap`: tileset/source/set_tile/paint)	Não	Não	Sim (células TileMapLayer)
Camadas de física / corpos	Sim (`physics`: layers/collision/body_config)	Não	Não	Sim (colisão/juntas/raycast)
Gerenciamento de barramentos de áudio	Sim (`audio`: buses/effects/streams)	Não	Não	Sim (barramentos/roteamento/efeitos)
Configuração de navegação	Sim (`navigation`: region/agent/obstacle)	Não	Não	Sim (navegação)
Criação de controles de UI	Sim (`ui`: control/theme/layout)	Não	Parcial (via adicionar nó)	Sim (controles/temas/menus)
Edição do mapa de entrada	Sim (`input_map`: action/event)	Não	Não	Sim (ações/atalhos de teclado)
Conexões de sinais	Sim (`signals`: conectar/desconectar/listar)	Não	Não	Sim (conectar/emitir/aguardar)
Iniciar editor / executar projeto	Sim (`editor`, `project` executar/parar)	Sim	Sim	Sim
Funciona sem o editor em execução	Sim (análise textual de `.tscn`)	Sim (ponte GDScript headless)	Sim (ponte GDScript headless)	Parcial (CLI headless ou socket TCP ao vivo)
Sem credenciais armazenadas (TC-Local)	Sim	Sim	Sim	Sim
Transportes stdio + HTTP	Sim (stdio padrão + `--http`)	Não (apenas stdio)	Não (apenas stdio)	Não (apenas stdio)
Imagem Docker (amd64 + arm64)	Sim	Não	Não	Não
Descrições de ferramentas em camadas de tokens	Sim (compacto + `help` sob demanda)	Não	Não	Não

Configuração

O binário do Godot é detectado automaticamente em locais comuns de instalação e PATH. Nenhuma variável de ambiente é necessária para uso básico. Opcionalmente, defina GODOT_PROJECT_PATH e GODOT_PATH para substituir os padrões.

Variável	Obrigatória	Padrão	Descrição
`GODOT_PROJECT_PATH`	Não	-	Caminho padrão do projeto (as ferramentas também aceitam um parâmetro `project_path`)
`GODOT_PATH`	Não	Detectado automaticamente	Caminho para o binário do Godot

Transporte HTTP

O servidor executa via stdio por padrão. Para servir via Streamable HTTP, passe --http ou defina MCP_TRANSPORT=http (TRANSPORT_MODE=http também é aceito). O modo HTTP expõe um endpoint /mcp sem autenticação -- não há credenciais para proteger, portanto é destinado a uso local confiável ou self-hosted.

Variável	Obrigatória	Padrão	Descrição
`MCP_TRANSPORT`	Não	`stdio`	Defina como `http` para transporte Streamable HTTP
`PORT`	Não	`0` (atribuição automática)	Porta HTTP (apenas modo HTTP)
`HOST`	Não	Padrão do servidor	Host HTTP (apenas modo HTTP)

Limitações

Requer uma estrutura de projeto Godot 4.x; um binário do Godot é opcional para operações de arquivo
Arquivos de cena (.tscn) são analisados/modificados via manipulação de texto, não pela API interna do Godot
Ações run/stop/export exigem que o binário do Godot esteja instalado
O modo Docker tem acesso limitado ao sistema de arquivos (monte seu diretório de projeto)

CLI

O binário better-godot-mcp executa o servidor MCP por padrão (stdio; adicione --http para Streamable HTTP). Ele também expõe dois subcomandos de diagnóstico para verificar seu ambiente Godot antes de conectar um cliente MCP.

Comando	Descrição
`better-godot-mcp`	Inicia o servidor MCP (stdio por padrão; `--http` para Streamable HTTP)
`better-godot-mcp detect`	Exibe o binário do Godot detectado como JSON (caminho, versão, origem); sai com código não zero quando nenhum é encontrado
`better-godot-mcp doctor`	Verifica a integridade do binário do Godot e do projeto atual (`GODOT_PROJECT_PATH`, caso contrário, o diretório de trabalho)

# Detect the Godot binary (JSON output)
npx -y @n24q02m/better-godot-mcp detect

{
  "found": true,
  "path": "/path/to/godot",
  "version": {
    "major": 4,
    "minor": 7,
    "patch": 1,
    "label": "stable.official",
    "raw": "4.7.1.stable.official"
  },
  "source": "system"
}

# Health-check the Godot binary and project
npx -y @n24q02m/better-godot-mcp doctor

[ok] godot binary: /path/to/godot (source: system)
[ok] godot version: 4.7.1.stable.official
[warn] project: no project.godot found at /path/to/cwd (set GODOT_PROJECT_PATH)

detect sai com 1 quando nenhum binário do Godot é encontrado; doctor sai com 1 quando o binário está ausente (um project.godot ausente é apenas um aviso).

Segurança

Detecção de binário -- Detecção do Godot em múltiplos caminhos (env, PATH, locais comuns)
Validação de projeto -- Verifica se project.godot existe antes das operações
Multiplataforma -- Tratamento de caminhos para Windows, macOS, Linux

Compilar a partir do código-fonte

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev          # stdio mode (default)
bun run dev:http     # Streamable HTTP mode

Modelo de confiança

Este plugin implementa TC-Local (sem autenticação necessária -- nenhuma credencial armazenada). Consulte a referência do modelo de confiança para a classificação completa.

Modo	Armazenamento	Criptografia	Quem pode ler seus dados?
stdio (padrão)	N/A (sem credenciais)	N/A	N/A
HTTP auto-hospedado	N/A (sem credenciais)	N/A	N/A

Licença

Apache-2.0 -- Consulte LICENSE.