gamedev-all-in-one-mcp

✨ Features

🔧 67 MCP Tools

Across 12 modules — scene management, scripting, instance CRUD, physics simulation per engine.

🌉 4 Engine Connectors

Auto-reconnecting bridges for Roblox (HTTP), Unity (TCP), Unreal (TCP), and Blender (TCP).

🤖 Built-in AI Console

Chat with Claude, GPT-4o, or Gemini directly from the dashboard — tools auto-execute.

🖥️ Web Dashboard

Real-time SSE monitoring at `localhost:3100` with glassmorphism dark theme UI.

⚡ Physics Engine

Per-engine gravity, rigid bodies, constraints, raycasting, force/impulse simulation.

🔌 Universal Compatibility

Works with Claude Desktop, Cursor, Claude Code, OpenCode, VS Code Copilot, and any MCP client.

🎯 Supported Engines

20 tools

HTTP Long-Poll Bridge

Port 3002

Luau Plugin Included

15 tools

TCP Socket Bridge

Port 7890

C# EditorWindow

15 tools

TCP Socket Bridge

Port 55557

C++ Plugin

13 tools

TCP Socket Bridge

Port 9876

Python Addon

🚀 Quick Start

# 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

Then open http://127.0.0.1:3100 for the web dashboard.

MCP Client Configuration

Add to your MCP client config (Claude Desktop, Cursor, etc.):

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

🏗 Architecture

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 StudioLuau Plugin"]
        UE["Unity EditorC# EditorWindow"]
        UEE["Unreal EditorC++ Plugin"]
        BE["BlenderPython 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

📦 Tool Inventory (67 tools)

🔧 Foundation — 4 tools

🟦 Roblox — 20 tools

⬛ Unity — 15 tools

⬜ Unreal Engine — 15 tools

🟧 Blender — 13 tools

🖥️ Web Dashboard

The built-in dashboard at http://127.0.0.1:3100 features a dark glassmorphism UI:

AI Console Providers

> API keys are stored in localStorage only — never sent to or stored on the server.

🔌 Roblox Studio Plugin

A production-ready single-file plugin is included.

Installation

1. Copy `runtime/roblox-studio-plugin/GamedevAllInOne.server.lua` to your Plugins folder:

2. Restart Roblox Studio

3. Enable: Game Settings > Security > Allow HTTP Requests = ON

4. Start the server with `npm run dev`

5. Plugin auto-connects on load

Plugin Features

• 20 command handlers (script CRUD, instance CRUD, physics, raycast)
• Auto-handshake with bridge on startup
• HTTP long-poll command loop with `pcall`-wrapped requests
• Toolbar button to start/stop runtime

🌉 Bridge Architecture

> All bridges bind to `127.0.0.1` only. TCP bridges auto-reconnect with configurable intervals.

⚙️ Configuration

Environment Variables

🔒 Security

• Loopback only — all bridges bind to `127.0.0.1`
• Host validation — requests with invalid Host headers are rejected
• Origin-restricted CORS — only localhost origins permitted
• Body size limits — 1 MiB max on Luau bridge, 64 KiB on dashboard API
• Input validation — Zod schemas on all bridge endpoints
• No server-side secrets — API keys live in browser localStorage only
• Graceful degradation — port conflicts disable individual services without crashing

🛠 Development

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

Project Structure

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

🤝 Contributing

Contributions are welcome! Here's how to get started:

1. Fork the repository

2. Create a feature branch: `git checkout -b feat/amazing-feature`

3. Commit your changes: `git commit -m 'feat: add amazing feature'`

4. Push to the branch: `git push origin feat/amazing-feature`

5. Open a Pull Request

Areas We'd Love Help With

• 🎮 Engine plugins — C# EditorWindow for Unity, C++ plugin for Unreal, Python addon for Blender
• 🧪 Tests — unit tests, integration tests, E2E bridge tests
• 📚 Docs — tutorials, video walkthroughs, example prompts
• 🌐 i18n — translations for the dashboard UI
• 🔧 New tools — animation, audio, terrain, lighting tools per engine

📚 Upstream References

Projects that inspired this work

📄 License

AGPL-3.0-only — see LICENSE for details.

• Improvements to the server must remain open source
• Networked or hosted variants must not become closed forks
• MIT and Apache-2.0 upstream code adapted with attribution preserved