unity3d-mcp

Unity3D MCP Server

📖 Installation Guide — quick start, manual setup, and troubleshooting

FastMCP 3.2.0+ Compliant - Comprehensive Unity 3D automation with VRM avatar pipeline and VRChat integration.

• Competitive Analysis
• Roadmap (Phases 1–5)

Agent Lab (v1.5.0)

Tool	Purpose
unity_bridge	Live Editor bridge — execution_mode (Hands-In vs Hands-Off), hierarchy, CRUD
unity_render	Agent vision — capture, multi-angle, scene summary
unity_vision_refine	Review bundle + apply bridge commands after vision model feedback
unity_import	Blender/fleet handoff — GLB/VRM/FBX batch import into Assets
unity_validation	Scene/avatar preflight — polycount, materials, missing scripts, unified audit
unity_api	Scene objects, modify, create_prefab, run_simulation
unity_jobs	Async build, batch_import, simulation
worldlabs	Marble import + assemble_review agent loop
multiplatform	CVR/Resonite/Cluster + audit_all unified platform audit

Copy src/unity3d_mcp/resources/MCPBridge.cs to your project's Assets/Editor/ folder.

Webapp Agent Tools page: /agent-tools (mirror blender-mcp Agent Lab UI).

Dual mode (live GUI vs headless)

Mode	When	You see
Hands-In	Unity Editor + MCPBridge.cs (:10835)	Scene edits, play-mode sim, captures live in Editor
Hands-Off	No bridge / disk-only	UnityPy edits, imports, build jobs (-batchmode, no GUI)

unity_bridge(operation='execution_mode') reports current mode. See docs/DUAL_MODE.md.

Observability (v1.5)

• Prometheus: http://127.0.0.1:9092/metrics and /api/v1/metrics on :10831
• JSON logs: UNITY3D_MCP_LOG_FORMAT=json
• Docker: docker compose --profile monitoring up -d — docs/MONITORING.md, docs/DOCKER.md

Fleet pipeline (Blender → Unity)

.\scripts\run-fleet-pipeline.ps1 -ProjectPath "D:\Unity\MyProject" -ModelPath "D:\exports\avatar.glb" -SkipBuild

See docs/FLEET_PIPELINE.md.

blender-mcp export GLB/VRM → unity_import import_blender → unity_vision_refine review_bundle → VRChat/build
worldlabs Marble → worldlabs assemble_review → agent fixes → unity_jobs build

One-shot automation: docs/FLEET_PIPELINE.md — scripts/run-fleet-pipeline.ps1

git clone https://github.com/sandraschi/unity3d-mcp
cd unity3d-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

Features

Core Unity Automation

• Unity Editor Management: Launch, control, and automate Unity Editor
• Project Operations: Create, configure, and manage Unity projects
• Scene Management: Create and manipulate Unity scenes
• Build Pipeline: Automated builds for multiple platforms

Avatar & VRM Pipeline

• VRM Import: Import and configure VRM avatars for Unity
• Avatar Optimization: Optimize avatars for VRChat compatibility
• Animation System: Setup animator controllers and animation clips
• Performance Profiling: Analyze and optimize avatar performance

Asset Management

• Package Import: Import Unity asset packages
• Texture Optimization: Platform-specific texture optimization
• Material Management: Create and convert materials for VRChat
• Asset Organization: Automated asset organization and versioning

VRChat Integration

• SDK Automation: Automate VRChat SDK operations
• Avatar Upload: Upload avatars to VRChat platform
• OSC Communication: Real-time OSC parameter control
• Performance Validation: VRChat-specific performance validation
• Authentication: VRChat API auth with 2FA/TOTP support

Multi-Platform Social VR