mcpup-ai
MCP Servermcpup-aipublic

mcp unity games

A development framework designed to enhance Unity Editor automation capabilities, providing tools for menu execution, object manipulation, package management, and more.

Repository Info

1
Stars
0
Forks
1
Watchers
0
Issues
TypeScript
Language
-
License

About This Server

A development framework designed to enhance Unity Editor automation capabilities, providing tools for menu execution, object manipulation, package management, and more.

Model Context Protocol (MCP) - This server can be integrated with AI applications to provide additional context and capabilities, enabling enhanced AI interactions and functionality.

Documentation

CubeAIx: A MCP Framework for Entire Workflow Twitter

License Unity Version Node.js Version Node.js Version MCP Version

Vision for CubeAIx

A Universal Framework for Unified Creative Pipeline

framework

First Integrated Solution for Game Development

A Live Demo with Unity 2025 LTS

!Demo screenshot

Core Toolchain

  • Modeling & Sculpting

    • Blender (open-source modeling), Maya (industrial-grade modeling), ZBrush (digital sculpting)
    • Cross-software asset library auto-sync (supports .fbx/.gltf format conversion)
  • VFX & Animation

    • Houdini (procedural effects), After Effects (motion graphics), MotionBuilder (mocap integration)
    • Real-time animation preview directly linked to game engines (supports Unity/Unreal dual drivers)
  • Engine Development

    • Unreal Engine 5 (Nanite/Lumen stack), Unity 2025 LTS (DOTS architecture), Godot 5 (lightweight deployment)
    • Cross-engine material system (auto-convert HLSL ↔ Shader Graph)

Automated Workflow Examples

  1. Blender → Unreal Asset Pipeline

    • Mesh topology optimization → LOD generation → Physics collision body construction → UE5 Blueprint component packaging
  2. Houdini → Niagara FX Baking

    • Parametric particle effect generation → GPU baking → Real-time wind/fluid data stream injection
  3. Multi-Software Version Control

    • Git-LFS based incremental sync (Maya project files ↔ Blender scenes ↔ Unity prefabs)

Expansion to Film Production

Photography Studio Module

  • Integrated Adobe Lightroom (RAW AI processing), DALL·E 5 (concept art generation), NVIDIA Omniverse (multi-camera virtual shooting)
  • Automated retouching pipeline: RAW denoising → AI color grading → Multi-platform resolution adaptation

Film Production Module

  • Virtual Production System
    • Unreal virtual scenes → ARRI camera metadata binding → DaVinci Resolve live color grading
  • AI-Assisted Creation
    • Script structure analysis → Storyboard auto-generation → Dynamic resource allocation (parallel character/scene/VFX production)

Technical Architecture Highlights

  • Universal Middleware Protocol
    # MCP protocol example: Cross-software command forwarding
    def mcp_translate(command):
        if command.source == "Blender":
            return unreal_engine_adapter(command)
        elif command.source == "Houdini":
            return unity_particle_adapter(command)
    

Version

Unity integration has been completed, more software coming soon

Architecture

first MCP Unify Game Production Pipeline and Next-Gen Game Production Framework

1. Unity Plugin (editor)

Subsystem Specifications

ModuleTechnical ImplementationPerformance Metrics
WebSocket ClientNativeWebSocket with binary protocol compression<100ms round-trip latency
Hot Code EngineRoslyn-based C# 8.0 dynamic compilation500ms code hot-swap
State TrackerScriptableObject delta serialization10MB/s throughput
Logging SystemMulti-category logging with Console integration10k+ logs/sec processing

2. unity-mcp-server (Cross-Platform Service Hub)

Implements the Message Control Protocol (MCP) specification v2.3 for seamless integration with the Unity Editor extension. Communication occurs through a persistent WebSocket channel (RFC 6455 compliant) supporting binary/text frames.

Key Components

  1. Protocol Layer

    • MCP-compliant message encapsulation with CRC32 checksum
    • Version negotiation during handshake (supports MCP v2.0 - v2.3)
  2. Transport Mechanism

    • Secure WebSocket (wss://) implementation
    • Message compression via LZ4 algorithm
    • Keep-alive heartbeat interval: 15 seconds
  3. Data Format

    • JSON Schema 2020-12 validated payloads
    • Custom serialization for Unity-specific data types:
      • Vector3/Quaternion precision optimization
      • GameObject reference resolution
      • Scene hierarchy delta encoding
  4. Command Pipeline

    • Asynchronous message queue with priority levels
    • Transactional command sequencing (ID-based tracking)

Usage

Unity Editor Interaction Layer

1. State Monitoring Suite

  • get_editor_state: Real-time capture of global editor status (project configuration, play mode state, compilation progress)
  • verify_connection: Maintain bidirectional heartbeat detection with connection quality metrics

2. Scene Operation Engine

  • get_current_scene_info: Analyze scene hierarchy (including Transform tree topology and component distribution heatmap)
  • get_game_objects_info: Deep scan GameObject metadata (with component dependency chains and material reference graphs)

3. Execution Control Module

  • execute_editor_command: Support C#8.0 syntax JIT compilation in sandboxed environment (with error isolation)
  • get_logs: Dynamic log stream filtering (triple-filter by log type/temporal window/keywords)

Project File Management System

4. Basic File Operations

  • read_file: Binary-safe reading (auto-detects UTF-8/UTF-16 encoding)
  • write_file: Atomic write operations with *.bak auto-backup
  • edit_file: Diff engine with line-level patch application

5. Batch Processing Interface

  • read_multiple_files: Parallel I/O optimized reading (supports up to 128 files)
  • list_scripts: C# script intelligent indexing (namespace resolution & class inheritance mapping)

6. Directory Navigation System

  • list_directory: Real-time filesystem snapshot (with hidden file visibility control)
  • directory_tree: ASCII tree generation (configurable depth & filter patterns)

7. Advanced Search Tools

  • search_files: PCRE2 regex engine implementation
  • get_file_info: NTFS extended attributes extraction (with file hash generation)

8. Asset Management Module

  • find_assets_by_type: Type fingerprint recognition (supports 200+ asset types including Shader/Material/Prefab)

Technical Feature Matrix

Feature DimensionEditor Tools CharacteristicsFilesystem Characteristics
RealtimeMillisecond-level state syncAsynchronous I/O queue management
SecuritySandboxed execution environmentWrite permission verification
ExtensibilityDynamic plugin architectureCustom file watchers
Data ScaleSupports 100k+ GameObject scenesHandles TB-scale project repositories
Cross-PlatformWindows/macOS/Linux full supportUnified path normalization

Installation Guide

Prerequisites

  • Unity 2021.3 or later
  • Node.js 18+ (for running the MCP server)

1. Install Unity Package

Installation Options

Via Unity Package Manager (Git URL)

  1. Open Unity Package Manager
    Window > Package Manager
  2. Add Git repository:
    Click +Add package from git URL...
  3. Enter repository URL:
    https://github.com/nasimali5/mcpup.git
  4. Complete installation:
    Click Add button

2. Configure MCP Server

Deployment Options A

# Navigate to server directory
cd <path-to-project>/Library/PackageCache/com.nasimali5.mcpup@42c7f8e7df0f/mcpServer/

# Install dependencies
npm install

# Start server
node build/index.js

Deployment Options B

Add the server to your MCP Host configuration for Claude Desktop, Custom Implementation etc

{
  "mcpServers": {
    "mcpup-server": {
      "command": "node",
      "args": [
        "path-to-project>\\Library\\PackageCache\\com.nasimali5.mcpup@42c7f8e7df0f\\mcpServer\\build\\index.js"
      ],
      "env": {
        "MCP_WEBSOCKET_PORT": "8080"
      }
    }
  }
}

Quick Start

1

Clone the repository

git clone https://github.com/mcpup-ai/mcp-unity-games
2

Install dependencies

cd mcp-unity-games
npm install
3

Follow the documentation

Check the repository's README.md file for specific installation and usage instructions.

Repository Details

Ownermcpup-ai
Repomcp-unity-games
LanguageTypeScript
License-
Last fetched8/10/2025

Recommended MCP Servers

💬

Discord MCP

Enable AI assistants to seamlessly interact with Discord servers, channels, and messages.

integrationsdiscordchat
🔗

Knit MCP

Connect AI agents to 200+ SaaS applications and automate workflows.

integrationsautomationsaas
🕷️

Apify MCP Server

Deploy and interact with Apify actors for web scraping and data extraction.

apifycrawlerdata
🌐

BrowserStack MCP

BrowserStack MCP Server for automated testing across multiple browsers.

testingqabrowsers

Zapier MCP

A Zapier server that provides automation capabilities for various apps.

zapierautomation