Unity3D MCP服务器

符合FastMCP 3.2.0+标准 -通过VRM头像管道和VRChat集成实现全面的Unity 3D自动化。

特性

核心Unity自动化

Unity编辑器管理：启动、控制和自动化Unity编辑器
项目运营：创建、配置和管理Unity项目
场景管理：创建和操纵Unity场景
构建管道：针对多个平台的自动化构建

Avatar和VRM管道

VRM导入：为Unity导入和配置VRM化身
头像优化：优化化身以实现VRChat兼容性
动画系统：设置动画师控制器和动画片段
性能分析：分析和优化化身性能

资产管理

包导入：导入Unity资产包
纹理优化：特定于平台的纹理优化
物料管理：为VRChat创建和转换材料
资产组织：自动化资产组织和版本控制

VRChat集成

SDK自动化：自动化VRChat SDK操作
头像上传：将头像上传到VRChat平台
OSC通信：实时OSC参数控制
性能验证：VRChat特定性能验证
认证：VRChat API验证，支持2FA/TOTP

多平台社交VR

平台	引擎	头像格式	SDK	状态
VRChat	Unity	VRC预制件	VRChat SDK	完全支持
ChilloutVR	Unity	CVR预制件	CCK	支持
共振	FrooxEngine	VRM/GLB直接	无需	支持
簇	Unity	VRM	创建者工具包	支持

ChilloutVR：CCK检测、CVRAvatar设置、验证
共振：直接导入VRM/GLB（无需Unity！）
簇：支持VRM的日本社交VR

Unity编辑器API工具（高级）

\*\*未来增强\*\*-为Unity Editor API集成搭建支架

这些工具为CLI无法处理的高级操作提供了对Unity Editor API的直接访问：

核心API工具

方法执行: api_execute_method() -执行具有复杂参数的Unity方法
现场检查: api_get_scene_objects() -获取详细的场景对象信息
对象操纵: api_modify_object() -直接对象属性修改
预制件制作: api_create_prefab() -使用适当的参考创建预制件
物理模拟: api_run_simulation() -运行物理模拟并记录数据
批量操作: api_batch_operations() -原子多操作执行

路径移动工具

路径动画: api_move_along_path() -沿直线/样条线/2D/3D路径移动对象
路径可视化: api_create_path_visualization() -创建视觉路径表示
二维路径跟踪: api_follow_path_2d() -2D旋转运动和前瞻
3D路径跟踪: api_follow_path_3d() -带有倾斜和仰角的3D运动
部队移动控制: api_stop_path_movement() -减速停止路径移动

电机控制工具

添加电机: api_add_motor() -将可配置的电机连接到物体上
起动电机: api_start_motor() -通过速度/加速度控制启动电机
停止电机: api_stop_motor() -带减速选项的停止电机
设置速度: api_set_motor_speed() -运行过程中的动态速度调整
电机状态: api_get_motor_status() -实时电机监测和诊断
物理配置: api_configure_motor_physics() -真实的电机物理模拟

导入/导出工具

导入包: import_asset_package() -导入Unity.unitypackage文件
导入三维模型: import_3d_model() -进口FBX、OBJ、GLTF等。
导入纹理: import_texture() -使用特定类型的设置导入纹理
导出FBX: export_fbx() -将对象导出为FBX格式
导出程序包: export_unity_package() -创建.unitypackage文件
出口预制件: export_prefab() -将对象导出为预制件
批量导入: batch_import() -一次执行多个导入
导入状态: get_import_status() -监控导入操作进度
导出状态: get_export_status() -监控导出操作进度

VRM头像工具（Unity集成）

将VRM导入Unity: import_vrm_to_unity() -将VRM导入Unity项目
Unity索具安装: setup_unity_avatar_rigging() -配置Unity人形索具
Unity材料: configure_unity_materials() -设置Unity特定材料
构建头像包: build_unity_avatar_package() -创建完整的Unity包
Avatar mcp集成: integrate_with_avatarmcp() -连接到头像mcp进行合成
导入状态: get_unity_import_status() -监控Unity VRM导入进度
传统VRM导入: import_vrm_avatar() -基本VRM导入（委托给头像mcp）

*注意：这些工具目前是脚手架式的，返回“未实施”状态。它们需要Unity Editor插件开发才能实现完整功能。*

代理采样（SEP-1577）

FastMCP 3.2.0+介绍 代理采样，允许服务器借用客户端的LLM来自主编排复杂的工作流。

unity3d_agentic_workflow：执行基于任务的目标（例如，“设置一个新的VRChat项目并导入我的头像”）。

情境发现（技能和提示）

该服务器通过SOTA技能系统提供专家指令和预定义的工作流程。

技能

可通过 resource://unity3d/skills/:

unity-editor-automation：编辑控制专家指南。
vrc-avatar-pipeline：VRM到VRChat优化指南。

提示

已注册的SOTA提示：

unity_setup_workflow：项目初始化指南。
vrc_avatar_workflow：VRM优化生命周期说明。

双模式操作

此服务器独特地支持两种不同的操作模式，以在开发和CI/CD环境中实现最大的灵活性。

1.参与（活动会话）

实时控制正在运行的Unity编辑器。需要 MCPBridge.cs 插件。

工具: unity3d_editor_api, unity3d_bridge_status
用例：场景布局、实时调试、照明设置和实时层次操纵。
港口：10835（HTTP）
指南：\[实时编辑器自动化\](file:///D:/Dev/repos/unity3d-mcp/docs/GUIDE_EDITOR_AUTO.md）

2.放手（磁盘操作）

直接操作磁盘上的Unity资产。由...驱动 UnityPy 的.

工具: unity3d_disk_api
用例：CI/CD管道、批处理资产审计、纹理提取和快速预制修复，无需启动Unity。
支持：序列化文件（.unity、.profab、.reset）+unity YAML源文件。
指南：\[直接磁盘操作\](file:///D:/Dev/repos/unity3d-mcp/docs/ARCHITECTR_DUAL_MODE.md#模式-手持-离盘操作）

______________________________________________________________________

技术文档

全面的技术套件可在 \[文档门户\](file:///D:/Dev/repos/unity3d-mcp/docs/README.md）.

核心概念

\[建筑深度学习\](file:///D:/Dev/repos/unity3d-mcp/docs/ARCHITECTURE_DUAL_MODE.md）：动手与不动手分析。
\[完整的API参考资料\](file:///D:/Dev/repos/unity3d-mcp/docs/API_REFERENCE.md）：所有50+工具的详细信息。

专用管道

\[VRM到VRChat指南\](file:///D:/Dev/repos/unity3d-mcp/docs/GUIDE_VRCHAT_PIPELINE.md）：高保真化身优化。
\[场景自动化指南\](file:///D:/Dev/repos/unity3d-mcp/docs/GUIDE_EDITOR_AUTO.md）：实时编辑器控件。

技术标准

FastMCP 3.2.0+：采用ASGI/Uvicorn和SEP-1577采样的最新MCP协议实施。
代理工作流：使用双模智能的集成自主编排。
模块化技能：桥安装和磁盘操作的专家说明。
结构化日志记录：JSON格式的日志通过 structlog.
安全：已应用CVE-2025-62801和CVE-2025-62800修复程序。

世界实验室集成

大理石进口：从World Labs Marble导入人工智能生成的3D世界
凿子支架：适用于Chisel编辑环境
高斯泼溅：安装渲染器 .ply/.splat 文件
VRChat优化：VRChat世界上传建议
格式支持：OBJ、FBX、GLB、GLTF网格+高斯散斑

UniVRM管理

包装检测：检查是否安装了UniVRM
自动安装：通过包管理器安装UniVRM 0.x或1.0
项目模板：使用预先配置的UniVRM创建项目

高级功能

双接口：stdio和HTTP（ASGI/Uvicorn）接口。
FastMCP 3.2.0：具有采样支持的现代MCP服务器架构。
综合录井：具有性能指标的结构化日志记录。
平台管理：多平台构建和优化。
路径解析：智能Unity安装检测。

安装

先决条件

紫外线已安装（推荐）
Python 3.12+

快速开始

立即通过运行 uvx:

uvx unity3d-mcp

Claude桌面集成

添加到您的 claude_desktop_config.json:

"mcpServers": {
  "unity3d-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/unity3d-mcp", "run", "unity3d-mcp"]
  }
}

来自PyPI（推荐）

pip install unity3d-mcp

包装与配送

该存储库符合SOTA 2026标准，并使用经过官方验证的 @anthropic-ai/mcpb 分发工作流程。

包扩展

生成一个 .mcpb 包含完整源代码和自动构建排除的发行包：

# SOTA 2026 standard pack command
mcpb pack . dist/unity3d-mcp.mcpb

来自GitHub发布

# Direct wheel download
pip install https://github.com/sandraschi/unity3d-mcp/releases/download/v1.2.0/unity3d_mcp-1.2.0-py3-none-any.whl

# Or from git
pip install git+https://github.com/sandraschi/unity3d-mcp.git

配置

创建配置文件或使用环境变量：

{
  "unity_editor_path": "C:/Program Files/Unity/Hub/Editor/2022.3.0f1/Editor/Unity.exe",
  "project_path": "D:/Unity Projects",
  "auto_detect_unity": true,
  "enable_http": true,
  "http_port": 8080,
  "log_level": "INFO"
}

用法

命令行

# Start in stdio mode
unity3d-mcp --mode stdio

# Start HTTP server
unity3d-mcp --mode http --port 8080

# Dual mode (stdio + HTTP)
unity3d-mcp --mode dual

MCP工具

核心团结行动

launch_unity_editor：使用项目启动Unity编辑器
create_unity_project：创建新的Unity项目
execute_unity_method：执行Unity编辑器方法

头像管理

import_vrm_avatar：将VRM头像导入Unity
setup_avatar_animator：配置动画师控制器
optimize_for_vrchat：应用VRChat优化

资产运营

import_asset_package：导入Unity软件包
optimize_textures：优化平台纹理
create_material：创建Unity材质

构建管道

build_unity_project：为目标平台构建
switch_platform：切换Unity平台
optimize_for_platform：应用平台优化

VRChat集成

upload_vrchat_avatar：将头像上传到VRChat
vrchat_check_auth：检查身份验证状态
vrchat_authenticate：使用VRChat API进行身份验证
vrchat_check_sdk：验证SDK安装
vrchat_validate_avatar：上传前验证头像
send_avatar_parameter：发送OSC参数
send_chatbox_message：发送VRChat聊天框消息

世界实验室（大理石/凿子）

import_marble_world：从Marble导出导入3D世界
check_gaussian_splatting：检查渲染器安装
install_gaussian_splatting：安装高斯喷涂包
optimize_worldlabs_for_vrchat：获取VRChat优化提示

UniVRM管理

check_univrm_installed：检查UniVRM安装
install_univrm：安装UniVRM软件包
create_unity_project_with_univrm：使用UniVRM创建项目

建筑

unity3d_mcp/
 core/           # Unity Editor automation, project management, UniVRM
 avatar/         # VRM avatar management
 assets/         # Asset import and optimization
 build/          # Build pipeline management
 vrchat/         # VRChat SDK integration + authentication
 worldlabs/      # World Labs Marble/Chisel integration
 utils/          # Shared utilities

测试

# Run all tests
.\scripts\run-tests.ps1

# Run with coverage
.\scripts\run-tests.ps1 -Coverage

# Run E2E tests (requires Unity)
.\scripts\run-tests.ps1 -E2E

# Run specific test pattern
.\scripts\run-tests.ps1 -Pattern "test_worldlabs"

需求

Python 3.8+
Unity编辑器（2019.4 LTS或更新版本）
VRChat SDK（用于VRChat功能）
Windows 10/11（主要支持）

演出

针对以下方面进行了优化：

VRChat头像要求
移动VR平台
多平台部署
实时OSC通信

🛡️ 工业级质量堆栈

该项目坚持 索塔14.1 高保真代理编排的工业标准：

Python（核心）: 拉夫用于裁剪和格式化。零容忍 print 核心处理程序中的语句(T201).
Web应用程序（用户界面）: 生物群系用于亚毫秒级的起毛。严格 noConsoleLog 执行。
协议遵从：硬化 stdout/stderr 隔离，以确保防崩溃的JSON-RPC通信。
自动化: Justfile 所有舰队行动的食谱(just lint, just fix, just dev).
安全：通过以下方式进行自动化审计 bandit 和 safety.

许可证

MIT许可证-请参阅许可证了解详情。

贡献

分叉存储库
创建要素分支
进行更改
添加测试
提交拉取请求

支持

文档：
问题：
讨论：

Webapp仪表板

此MCP服务器包括用于监视和控制的高级SOTA web界面。

港口分配（标准化）

前端: 10830 （Vite/React）
后端（API）: 10831 （FastAPI/FastMCP）

要启动Web应用程序，请执行以下操作：

导航到 web_sota 目录。
跑 start.bat （Windows）或 ./start.ps1 （PowerShell）。
仪表板将在以下时间自动打开 http://localhost:10830.

Unity3d MCP

快速接入

详细介绍

Unity3D MCP服务器

特性

核心Unity自动化

Avatar和VRM管道

资产管理

VRChat集成

多平台社交VR

Unity编辑器API工具（高级）

核心API工具

路径移动工具

电机控制工具

导入/导出工具

VRM头像工具（Unity集成）

代理采样（SEP-1577）

情境发现（技能和提示）

技能

提示

双模式操作

1.参与（活动会话）

2.放手（磁盘操作）

技术文档

核心概念

专用管道

技术标准

世界实验室集成

UniVRM管理

高级功能

安装

先决条件

快速开始

Claude桌面集成

来自PyPI（推荐）

包装与配送

包扩展

来自GitHub发布

配置

用法

命令行

MCP工具

核心团结行动

头像管理

资产运营

构建管道

VRChat集成

世界实验室（大理石/凿子）

UniVRM管理

建筑

测试

需求

演出

🛡️ 工业级质量堆栈

许可证

贡献

支持

Webapp仪表板

港口分配（标准化）

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP