Gamedev All-in-One MCP

"Hey Claude, create a red spinning cube in Unity, then replicate it in Roblox and Blender."

✨ Recursos

🎯 Engines Suportadas

20 ferramentas Ponte HTTP Long-Poll Porta 3002 Plugin Luau Incluído

15 ferramentas Ponte TCP Socket Porta 7890 C# EditorWindow

15 ferramentas Ponte TCP Socket Porta 55557 Plugin C++

13 ferramentas Ponte TCP Socket Porta 9876 Addon Python

🚀 Início Rápido

# Clone the repo
git clone https://github.com/nicepkg/gamedev-all-in-one.git
cd gamedev-all-in-one

# Install & build
npm install
npm run build

# Start the server
npm run dev

Em seguida, abra http://127.0.0.1:3100 para o painel web.

Configuração do Cliente MCP

Adicione à configuração do seu cliente MCP (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "gamedev-all-in-one": {
      "command": "node",
      "args": ["/absolute/path/to/gamedev-all-in-one/dist/index.js"]
    }
  }
}

🏗 Arquitetura

graph TB
    subgraph Client["🤖 MCP Clients"]
        CD[Claude Desktop]
        CR[Cursor]
        CC[Claude Code]
        OC[OpenCode]
        VS[VS Code Copilot]
    end

    subgraph Server["⚡ MCP Server — Node.js"]
        FND["🔧 Foundation (4 tools)"]
        RBX["🟦 Roblox (20 tools)"]
        UNI["⬛ Unity (15 tools)"]
        UNR["⬜ Unreal (15 tools)"]
        BLN["🟧 Blender (13 tools)"]
        WEB["🖥️ Dashboard :3100"]
    end

    subgraph Engines["🎮 Game Engines"]
        RS["Roblox Studio<br/>Luau Plugin"]
        UE["Unity Editor<br/>C# EditorWindow"]
        UEE["Unreal Editor<br/>C++ Plugin"]
        BE["Blender<br/>Python Addon"]
    end

    Client -->|stdio| Server
    RBX -->|"HTTP :3002"| RS
    UNI -->|"TCP :7890"| UE
    UNR -->|"TCP :55557"| UEE
    BLN -->|"TCP :9876"| BE

    style Client fill:#1e1b4b,stroke:#6366f1,color:#e0e7ff
    style Server fill:#0c4a6e,stroke:#0ea5e9,color:#e0f2fe
    style Engines fill:#431407,stroke:#f97316,color:#fff7ed

📦 Inventário de Ferramentas (67 ferramentas)

🖥️ Painel Web

O painel integrado em http://127.0.0.1:3100 apresenta uma interface dark glassmorphism:

Provedores do Console de IA

As chaves de API são armazenadas apenas no localStorage — nunca são enviadas ou armazenadas no servidor.

🔌 Plugin do Roblox Studio

Um plugin de arquivo único pronto para produção está incluído.

Instalação

1. Copie runtime/roblox-studio-plugin/GamedevAllInOne.server.lua para a sua pasta de Plugins:
   • Windows: %LOCALAPPDATA%\Roblox\Plugins\
   • Mac: ~/Documents/Roblox/Plugins/
2. Reinicie o Roblox Studio
3. Ative: Game Settings > Security > Allow HTTP Requests = ON
4. Inicie o servidor com npm run dev
5. O plugin conecta automaticamente ao carregar

Recursos do Plugin

• 20 manipuladores de comandos (CRUD de script, CRUD de instância, física, raycast)
• Handshake automático com a ponte na inicialização
• Loop de comandos HTTP long-poll com requisições encapsuladas em pcall
• Botão na barra de ferramentas para iniciar/parar o runtime

🌉 Arquitetura das Pontes

Todas as pontes vinculam-se apenas a 127.0.0.1. As pontes TCP reconectam automaticamente com intervalos configuráveis.

⚙️ Configuração

Variáveis de Ambiente

🔒 Segurança

• Apenas loopback — todas as pontes vinculam-se a 127.0.0.1
• Validação de host — requisições com cabeçalhos Host inválidos são rejeitadas
• CORS restrito por origem — apenas origens localhost são permitidas
• Limites de tamanho do corpo — máximo de 1 MiB na ponte Luau, 64 KiB na API do painel
• Validação de entrada — esquemas Zod em todos os endpoints das pontes
• Sem segredos no servidor — chaves de API ficam apenas no localStorage do navegador
• Degradação graciosa — conflitos de porta desativam serviços individuais sem travar

🛠 Desenvolvimento

npm run dev          # Start with tsx (hot reload)
npm run build        # TypeScript compile + copy dashboard
npm start            # Production mode
npm test             # Run tests

Estrutura do Projeto

src/
├── index.ts                        # Entry point + graceful shutdown
├── version.ts                      # NAME, VERSION constants
├── server/
│   └── create-server.ts            # McpServer + 12 tool module registration
├── connectors/
│   ├── shared/tcp-bridge.ts        # Shared TCP bridge (Unity/Unreal/Blender)
│   ├── roblox/index.ts             # Roblox detection + command dispatch
│   ├── luau/bridge.ts              # HTTP long-poll bridge (hardened)
│   ├── unity/index.ts              # Unity detection + TCP bridge
│   ├── unreal/index.ts             # Unreal detection + TCP bridge
│   └── blender/index.ts            # Blender detection + TCP bridge
├── tools/
│   ├── foundation.ts               # 4 foundation tools
│   ├── roblox*.ts                  # 20 Roblox tools (5 files)
│   ├── unity*.ts                   # 15 Unity tools (2 files)
│   ├── unreal*.ts                  # 15 Unreal tools (2 files)
│   └── blender*.ts                 # 13 Blender tools (2 files)
└── web/
    ├── server.ts                   # Dashboard HTTP + SSE + Chat API
    ├── llm-proxy.ts                # Multi-provider LLM with tool execution
    └── dashboard.html              # Single-file frontend (dark theme)

runtime/
└── roblox-studio-plugin/
    └── GamedevAllInOne.server.lua  # Production-ready Studio plugin

🤝 Contribuindo

Contribuições são bem-vindas! Veja como começar:

1. Faça um fork do repositório
2. Crie um branch de recurso: git checkout -b feat/amazing-feature
3. Faça commit das suas alterações: git commit -m 'feat: add amazing feature'
4. Envie para o branch: git push origin feat/amazing-feature
5. Abra um Pull Request

Áreas em que Gostaríamos de Ajuda

• 🎮 Plugins de engine — C# EditorWindow para Unity, plugin C++ para Unreal, addon Python para Blender
• 🧪 Testes — testes unitários, testes de integração, testes E2E das pontes
• 📚 Documentação — tutoriais, vídeos passo a passo, exemplos de prompts
• 🌐 i18n — traduções para a interface do painel
• 🔧 Novas ferramentas — ferramentas de animação, áudio, terreno e iluminação por engine

📚 Referências Upstream

📄 Licença

AGPL-3.0-only — consulte LICENSE para detalhes.

• Melhorias no servidor devem permanecer open-source
• Variantes em rede ou hospedadas não podem se tornar forks fechados
• Código upstream MIT e Apache-2.0 adaptado com atribuição preservada