• v9.6.3 (beta) — 新增 manage_profiler 工具（14 个动作）：性能分析器会话控制（开始/停止/状态查看/设置区域）、帧时间与计数器读取、对象内存查询、内存快照（通过 com.unity.memoryprofiler 进行拍摄/列出/比较）以及帧调试器（启用/禁用/获取事件）。所属组别：profiling。
• v9.6.2 — 新增 manage_physics 工具（21 个动作）：物理设置、层碰撞矩阵、物理材质、关节（5 种 3D + 9 种 2D 类型）、查询（射线检测、所有射线检测、线性射线检测、形状射线检测、重叠检测）、施加力（AddForce/AddTorque/AddExplosionForce）、刚体配置、场景级验证以及编辑模式下的模拟。全面支持 3D 和 2D 物理。
• v9.6.1 — 使用体验优化：manage_editor 增加撤销/重做操作。manage_scene 增加多场景编辑功能（叠加加载、关闭、设置激活状态、在不同场景间移动游戏对象）、场景模板（3d_basic、2d_basic 等）以及带自动修复功能的场景验证。新增 manage_build 工具：触发玩家构建、切换平台、配置玩家设置、管理构建场景和配置文件（Unity 6+）、跨多个平台执行批量构建，并通过轮询实现异步作业跟踪。同时引入了用于长时间运行工具操作的 MaxPollSeconds 基础设施。
• v9.5.4 — 新增 unity_reflect 和 unity_docs 工具，用于 API 验证：通过反射检查实时 C# API，并获取官方 Unity 文档（ScriptReference、Manual、包文档）。新增 manage_packages 工具：安装、移除、搜索和管理 Unity 包及作用域注册表。包含输入验证、移除时的依赖性检查以及 Git URL 警告。
• v9.5.3 — 新增 manage_graphics 工具（33 个动作）：体积/后期处理、光照烘焙、渲染统计、管线设置、URP 渲染器功能。新增 3 个资源：volumes、rendering_stats、renderer_features。
• v9.5.2 — 新增 manage_camera 工具，支持 Cinemachine（预设、优先级、噪点、混合、扩展），并新增 cameras 资源，通过 SerializedProperty 修复了优先级持久化问题。

Unity Asset Store：

1. 访问 MCP for Unity 在 Asset Store 上的页面
2. 点击“添加到我的资源”，然后通过 Window > Package Manager 导入。

OpenUPM：

openupm add com.coplaydev.unity-mcp

核心功能

• 自然语言控制 — 指示你的 LLM 执行 Unity 任务
• 强大工具 — 管理资源、场景、材质、脚本和编辑器功能
• 自动化 — 自动化重复性的 Unity 工作流程
• 可扩展性 — 适用于多种 MCP 客户端

可用工具

apply_text_edits • batch_execute • create_script • debug_request_context • delete_script • execute_custom_tool • execute_menu_item • find_gameobjects • find_in_file • get_sha • get_test_job • manage_animation • manage_asset • manage_build • manage_camera • manage_components • manage_editor • manage_gameobject • manage_graphics • manage_material • manage_packages • manage_physics • manage_prefabs • manage_probuilder • manage_profiler • manage_scene • manage_script • manage_script_capabilities • manage_scriptable_object • manage_shader • manage_texture • manage_tools • manage_ui • manage_vfx • read_console • refresh_unity • run_tests • script_apply_edits • set_active_instance • unity_docs • unity_reflect • validate_script

可用资源

cameras • custom_tools • renderer_features • rendering_stats • volumes • editor_active_tool • editor_prefab_stage • editor_selection • editor_state • editor_windows • gameobject • gameobject_api • gameobject_component • gameobject_components • get_tests • get_tests_for_mode • menu_items • prefab_api • prefab_hierarchy • prefab_info • project_info • project_layers • project_tags • tool_groups • unity_instances

性能提示： 对于多个操作，请使用 batch_execute — 它比单独调用快 10 到 100 倍！

如果自动设置无法正常工作，请将以下内容添加到您的 MCP 客户端配置文件中：

HTTP（默认 — 适用于 Claude Desktop、Cursor、Windsurf）：

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

VS Code：

{
  "servers": {
    "unityMCP": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

{
  "mcpServers": {
    "unityMCP": {
      "command": "uvx",
      "args": ["--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio"]
    }
  }
}

{
  "mcpServers": {
    "unityMCP": {
      "command": "C:/Users/YOUR_USERNAME/AppData/Local/Microsoft/WinGet/Links/uvx.exe",
      "args": ["--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio"]
    }
  }
}

MCP for Unity 支持多个 Unity 编辑器实例。要指定特定的实例：

1. 让您的 LLM 检查 unity_instances 资源
2. 使用 set_active_instance 并提供 Name@hash 格式（例如，MyProject@abc123）
3. 所有后续工具都会路由到该实例

对于能够捕获未定义的命名空间、类型和方法的严格验证：

1. 安装 NuGetForUnity
2. 打开 Window > NuGet Package Manager → 安装 Microsoft.CodeAnalysis v5.0
3. 同时安装 SQLitePCLRaw.core 和 SQLitePCLRaw.bundle_e_sqlite3 v3.0.2
4. 在 Player Settings > Scripting Define Symbols 中添加 USE_ROSLYN
5. 重启 Unity

• Unity Bridge 无法连接： 检查 Window > MCP for Unity 的状态，重启 Unity
• 服务器无法启动： 确认 uv --version 是否正常工作，查看终端是否有错误信息
• 客户端无法连接： 确保 HTTP 服务器正在运行，并且 URL 与您的配置匹配

详细设置指南：

• 修复 Unity MCP 和 Cursor、VSCode 以及 Windsurf — uv/Python 安装、PATH 问题
• 修复 Unity MCP 和 Claude Code — Claude CLI 安装
• 常见设置问题 — macOS dyld 错误、常见问题解答

仍然遇到困难？请提交问题或加入Discord

请参阅 README-DEV.md 了解开发设置。有关自定义工具的信息，请参阅 CUSTOM_TOOLS.md。

1. 分支 → 创建问题 → 创建分支（feature/your-idea）→ 进行更改 → 提交 PR

匿名且注重隐私的遥测数据（不包含代码、项目名称或个人数据）。您可以通过设置 DISABLE_TELEMETRY=true 来选择退出。更多信息请参阅 TELEMETRY.md。

网络默认设置为故意的安全关闭：

• HTTP Local 默认仅允许环回主机（127.0.0.1、localhost、::1）。
• 绑定所有接口（0.0.0.0、::）需要在高级设置中通过**允许 LAN 绑定（HTTP Local）**明确启用。
• HTTP Remote 默认要求使用 https://。
• 对于远程端点的明文 http://，需要通过允许不安全的远程 HTTP 明确启用。

@inproceedings{10.1145/3757376.3771417,
author = {Wu, Shutong and Barnett, Justin P.},
title = {MCP-Unity: Protocol-Driven Framework for Interactive 3D Authoring},
year = {2025},
isbn = {9798400721366},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
url = {https://doi.org/10.1145/3757376.3771417},
doi = {10.1145/3757376.3771417},
series = {SA Technical Communications '25}
}