mcp-godot-desenvolvimento

# 🎮 MCP Godot Agent > **Seu assistente de IA que cria jogos completos no Godot — da ideia ao lançamento.** <!-- BADGES_START --> []() [](https://godotengine.org/) [](https://python.org) [](https://modelcontextprotocol.io) [](LICENSE) []() []() <!-- BADGES_END --> > 📊 **Versão:** <!--DOCS_SYNC:version-->4.3.0<!--/DOCS_SYNC:version--> | **Tools:** <!--DOCS_SYNC:tools-->289<!--/DOCS_SYNC:tools--> | **Blueprints:** <!--DOCS_SYNC:blueprints-->29<!--/DOCS_SYNC:blueprints--> | **Behaviors:** <!--DOCS_SYNC:behaviors-->277<!--/DOCS_SYNC:behaviors--> | **Domínios:** <!--DOCS_SYNC:domains-->41<!--/DOCS_SYNC:domains--> > ⚠️ Números gerados por `scripts/docs_sync.py` — não edite manualmente. --- ## 📑 Índice - [O que é](#o-que-é) - [⚡ Comece em 1 minuto](#-comece-em-1-minuto) - [🎮 Vitrine de Gêneros (32)](#-vitrine-de-gêneros-32-gêneros) - [📊 Dashboard do Projeto](#-dashboard-do-projeto) - [🗺️ Para Contribuidores](#️-para-contribuidores) - [📂 Estrutura](#-estrutura) - [📖 Documentação](#-documentação) - [🔧 Requisitos](#-requisitos) --- ## O que é O **MCP Godot Agent** é um servidor MCP em Python que atua como **dono do processo** de desenvolvimento de um jogo Godot inteiro. Não é só uma ponte entre IA e engine — ele tem travas reais que impedem pular etapas, verificação automatizada e um guia passo a passo. **Para quem é:** Pessoas que querem criar um jogo mas não sabem programar. Você descreve o que quer em linguagem natural e a IA constrói. **O que ele faz:** - Cria projetos Godot completos a partir de uma frase - Gerencia 6 fases de desenvolvimento (Ideia → Design → Protótipo → Conteúdo → Polimento → Pronto) - Oferece 32 gêneros de jogos prontos para começar - Verifica cada etapa automaticamente (compilação, testes, smoke test) - Funciona offline para operações que não dependem de IA --- ## � Dashboard do Projeto | Métrica | Valor | |--------|:-----:| | Tools ativas | 289 | | Etapas do instalador | 14 | | Testes do instalador | 26/26 | | Behaviors | 277 | | Domínios | 41 | | Clientes IA suportados | 3 (VS Code, Claude, Cursor) | | Sistemas operacionais | 3 (Windows, macOS, Linux) | | Fases de desenvolvimento | 6 | | Blueprints de gêneros | 29 | | Godot | 4.7.1 | | Python | 3.12+ | | Score SOTA Instalador | 100/100 | --- ## 🗺️ Para Contribuidores | Arquivo/Pasta | O que é | |---|---| | [`.github/copilot-instructions.md`](.github/copilot-instructions.md) | Regras-mestre: o que é o projeto, 5 regras absolutas, teto de ferramentas, padrões técnicos | | [`AGENTS.md`](AGENTS.md) | Fluxo de trabalho do agente: comandos `/`, regras de convivência, o que nunca fazer | | [`HANDOFF.md`](HANDOFF.md) | Estado atual do projeto ("onde paramos") — atualizado a cada `/handoff` ou `/encerrar` | | [`docs/REGISTRY.md`](docs/REGISTRY.md) | Inventário completo: tools, behaviors, blueprints, addons, fases | | [`docs/sota/`](docs/sota/) | Planejamento estado da arte (7 ondas, 53 fatias) | | [`.github/instructions/`](.github/instructions/) | Regras técnicas por tema: aprendizados, camadas 0-7, fontes, autogovernança, behaviors | | [`.github/skills/`](.github/skills/) | Skills sob demanda (glossário, protocolo de pesquisa) | | [`docs/archive/`](docs/archive/) | 🗄️ Histórico — versões antigas de prompts, sessões passadas. Não é documentação ativa | --- ## ⚡ Comece em 1 minuto ```powershell # Windows: 2 cliques Abra a pasta INSTALADOR-MCP\ e clique em Instalar.bat # Ou no terminal: python -m instalador ``` > 📖 Guia completo: [`INSTALADOR-MCP/LEIA-ME.md`](INSTALADOR-MCP/LEIA-ME.md) **Comandos disponíveis após instalação:** | Comando | O que faz | |---|---| | `python -m instalador` | Instala/configura tudo automaticamente | | `python -m instalador --so-verificar` | Diagnostica sem alterar nada | | `python scripts/auto-ciclo.py` | Ciclo SOTA: audita → corrige → testa | | `/plan` | No Copilot: planeja a próxima etapa do jogo | | `/handoff` | Salva o progresso da sessão | | `/manual` | Manual completo de comandos | **Alternativa sem instalador:** ```powershell git clone https://github.com/joabcostamd/mcp-godot-desenvolvimento cd mcp-godot-desenvolvimento python -m venv .venv .venv\Scripts\pip install -r requirements.txt .venv\Scripts\python server.py --profile dev ``` --- ## 🎮 Vitrine de Gêneros (32 gêneros) Escolha um gênero e comece a criar. Use `quickstart_manage(op="showcase")` para ver a lista completa. ### ⭐ Fácil | Gênero | Experimente: | |---|---| | 🐍 Snake | "jogo da cobrinha, controle a cobra no grid" | | 🐦 Flappy Bird | "jogo do passarinho que voa entre canos" | | 🏓 Pong | "jogo de ping-pong com dois paddles e uma bola" | | 📈 Doodle Jump | "jogo de pular de plataforma em plataforma subindo" | | 🧠 Memória | "jogo da memória, vire as cartas e encontre os pares" | | 🧱 Breakout | "jogo de quebrar tijolos com bola e paddle" | | 🖱️ Idle Clicker | "jogo de clique incremental, automatize" | | 🌌 Asteroids | "jogo de nave no espaço, gire e atire" | | 💣 Campo Minado | "jogo de campo minado, deduza onde estão as minas" | ### ⭐⭐ Médio | Gênero | Experimente: | |---|---| | 👾 Space Invaders | "jogo de nave que atira em aliens" | | 🏃 Endless Runner | "jogo de corrida infinita, desvie dos obstáculos" | | 🫧 Bubble Shooter | "jogo de atirar bolhas coloridas, forme grupos" | | 🐸 Frogger | "jogo do sapo, atravesse a rua e o rio" | | 🎯 Top-Down Shooter | "jogo de nave que atira em asteroides" | | 🔫 Twin-Stick | "jogo de arena, mova e atire contra waves" | | 🧊 Tetris | "jogo de encaixar peças que caem" | | 📦 Sokoban | "jogo de empurrar caixas no grid" | | 🎮 Plataforma | "jogo de plataforma com pulo e coleta de moedas" | | 🕹️ Pac-Man | "jogo de labirinto, colete pontos e fuja dos fantasmas" | | 🧩 Match-3 | "jogo de combinar 3 peças coloridas no grid" | | 🏎️ Corrida | "jogo de corrida visto de cima" | | 🧲 Puzzle Física | "jogo de puzzle com física realista" | ### ⭐⭐⭐ Avançado | Gênero | Experimente: | |---|---| | 🏰 Tower Defense | "jogo de defesa de torre, posicione torres" | | 🧛 Vampire Survivors | "jogo de sobrevivência com ataque automático" | | ⚔️ RPG Turno | "RPG de turno, explore o mapa e lute" | | 🗡️ Dungeon Crawler | "dungeon procedural, explore salas aleatórias" | | 🃏 Deck Builder | "jogo de cartas estratégico, monte seu deck" | | 🗺️ Metroidvania | "exploração com plataforma e habilidades" | | 📖 Visual Novel | "história interativa com diálogos" | | 💥 Bullet Hell | "jogo de esquiva com dezenas de projéteis" | | 👊 Beat 'em Up | "jogo de luta de rua, derrote ondas de inimigos" | | 🥷 Stealth 2D | "jogo de furtividade, evite guardas nas sombras" | --- ## 📂 Estrutura | Pasta/Arquivo | O que é | |---|---| | `server.py` | Servidor MCP principal (289 ferramentas, stdio JSON-RPC 2.0) | | `init.py` | Instalador de 1 comando (só stdlib, zero dependências) | | `tools/` | 240+ módulos Python (cenas, scripts, física, arte, som, pipeline) | | `resources/` | 32 padrões de gêneros + 11 prompts MCP | | `addons/` | Plugins Godot (bridge, dock, runtime) | | `llms.txt` | Índice completo do projeto para IAs (padrão llmstxt.org) | | `docs/REGISTRY.md` | Inventário completo do projeto | --- ## 📖 Documentação | Documento | Conteúdo | |---|---| | `ROADMAP.md` | Progresso das ondas e fatias | | [AGENTS.md](AGENTS.md) | Regras para agentes de IA no repositório | | [docs/manual/](docs/manual/) | Manual do usuário (10 seções, gerado por código) | | [docs/tutorial/](docs/tutorial/) | Tutoriais progressivos (01 a 04) | | [CHANGELOG.md](CHANGELOG.md) | Histórico completo de versões | --- ## 🔧 Requisitos - Python 3.12+ - Godot 4.7 - VS Code + Copilot (ou qualquer cliente MCP) --- **Docs:** [docs/REGISTRY.md](docs/REGISTRY.md) | **llms.txt:** [llms.txt](llms.txt) | **GitHub:** [joabcostamd/mcp-godot-desenvolvimento](https://github.com/joabcostamd/mcp-godot-desenvolvimento) --- <p align="center"> _{Feito com ❤️ por <a href="https://github.com/joabcostamd">Joab Costa</a> — <a href="https://github.com/joabcostamd/mcp-godot-desenvolvimento/issues">Reportar Bug</a> · <a href="https://github.com/joabcostamd/mcp-godot-desenvolvimento/discussions">Discussões</a>} </p>