Gamedev All-in-One MCP

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

✨ Características

🎯 Motores Compatibles

20 herramientas Puente HTTP Long-Poll Puerto 3002 Plugin Luau Incluido

15 herramientas Puente TCP Socket Puerto 7890 EditorWindow en C#

15 herramientas Puente TCP Socket Puerto 55557 Plugin C++

13 herramientas Puente TCP Socket Puerto 9876 Addon Python

🚀 Inicio 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

Luego abre http://127.0.0.1:3100 para el panel de control web.

Configuración del Cliente MCP

Añade a la configuración de tu cliente MCP (Claude Desktop, Cursor, etc.):

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

🏗 Arquitectura

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

📦 Inventario de Herramientas (67 herramientas)

🖥️ Panel de Control Web

El panel de control integrado en http://127.0.0.1:3100 cuenta con una interfaz de glassmorphism oscuro:

Proveedores de la Consola de IA

Las claves de API se almacenan solo en localStorage — nunca se envían ni se guardan en el servidor.

🔌 Plugin de Roblox Studio

Se incluye un plugin de un solo archivo listo para producción.

Instalación

1. Copia runtime/roblox-studio-plugin/GamedevAllInOne.server.lua a tu carpeta de Plugins:
   • Windows: %LOCALAPPDATA%\Roblox\Plugins\
   • Mac: ~/Documents/Roblox/Plugins/
2. Reinicia Roblox Studio
3. Activa: Game Settings > Security > Allow HTTP Requests = ON
4. Inicia el servidor con npm run dev
5. El plugin se conecta automáticamente al cargar

Características del Plugin

• 20 manejadores de comandos (CRUD de scripts, CRUD de instancias, física, raycast)
• Handshake automático con el puente al iniciar
• Bucle de comandos HTTP long-poll con solicitudes envueltas en pcall
• Botón en la barra de herramientas para iniciar/detener el runtime

🌉 Arquitectura de Puentes

Todos los puentes se vinculan solo a 127.0.0.1. Los puentes TCP se reconectan automáticamente con intervalos configurables.

⚙️ Configuración

Variables de Entorno

🔒 Seguridad

• Solo loopback — todos los puentes se vinculan a 127.0.0.1
• Validación de host — se rechazan solicitudes con cabeceras Host inválidas
• CORS restringido por origen — solo se permiten orígenes localhost
• Límites de tamaño de cuerpo — máximo 1 MiB en el puente Luau, 64 KiB en la API del panel de control
• Validación de entrada — esquemas Zod en todos los endpoints de puentes
• Sin secretos en el servidor — las claves de API viven solo en localStorage del navegador
• Degradación elegante — los conflictos de puerto deshabilitan servicios individuales sin bloquearse

🛠 Desarrollo

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

Estructura del Proyecto

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

🤝 Contribuir

¡Las contribuciones son bienvenidas! Así es como empezar:

1. Haz un fork del repositorio
2. Crea una rama de características: git checkout -b feat/amazing-feature
3. Haz commit de tus cambios: git commit -m 'feat: add amazing feature'
4. Haz push a la rama: git push origin feat/amazing-feature
5. Abre una Pull Request

Áreas en las que Nos Encantaría Ayuda

• 🎮 Plugins de motores — EditorWindow en C# para Unity, plugin C++ para Unreal, addon Python para Blender
• 🧪 Pruebas — pruebas unitarias, pruebas de integración, pruebas E2E de puentes
• 📚 Documentación — tutoriales, recorridos en video, ejemplos de prompts
• 🌐 i18n — traducciones para la interfaz del panel de control
• 🔧 Nuevas herramientas — herramientas de animación, audio, terreno e iluminación por motor

📚 Referencias Ascendentes

📄 Licencia

AGPL-3.0-only — consulta LICENSE para más detalles.

• Las mejoras al servidor deben permanecer como código abierto
• Las variantes en red o alojadas no deben convertirse en forks cerrados
• Código ascendente MIT y Apache-2.0 adaptado con atribución preservada