Unity MCP Server

社区

330+ 工具，将 Claude 变成你的 Unity 编辑器与 Hub 全能副驾驶

分类: 开发工具第 258 / 438
Stars: ★ 492 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 5 天前

50FMRS · D

这是一个功能丰富的开源 Unity MCP 服务器，提供 330+ 工具，与同类产品相比（如 Bezi、Coplay MCP）覆盖最全面，且免费。它尤其适合使用 Claude Cowork 的开发者，其两层工具系统优化了工具列表体积。但需要用户熟悉环境配置，并且有数据操作风险，建议备份。

最强项 · 文档质量 15/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

6/20

维护活跃度

12/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 4/20: 仅提供了 README 与仓库元数据，未提供任何源码、测试文件或 CI 配置，无法验证服务能否正常启动、完成 MCP 初始化与工具列表握手，也无法确认声明的工具与真实行为一致。README 声称有 57 项测试和 CI，但属于不可信证据，不能据此加分；服务端 manifest 也未缓存。因此按缺失证据从低给分。
安全与权限 6/20: 未在材料中发现恶意代码、凭证窃取、隐蔽外传或安装示例含真实令牌等红线问题。但源码不可见，无法核实凭据处理、最小权限、网络边界以及对危险操作（如执行 C#、构建、删除资产）的确认机制。README 显示服务器通过本地 HTTP 桥接控制 Unity 编辑器，权限范围很大，却没有文档化的确认/审批流程，安全设计证据不足。
维护活跃度 12/20: 仓库未归档，README 显示了从 v2.28 到 v2.35 的系列版本更新、功能迭代、npm 自动发布说明，开放 issue 数量也较低，表明项目仍活跃。但许可证为 NOASSERTION，自定义的 AnkleBreaker Open License 无法从现有材料验证；也没有依赖更新记录或安全响应渠道。属于活跃但治理与版本管理有缺口的状况。
文档质量 15/20: README 覆盖了安装、配置项表格、故障排除、FAQ、平台限制和成本对比，结构清晰且示例充分。但缺少逐工具的参数参考文档，服务端 manifest 未缓存；且工具数量在标题中写 268、正文写 330+，存在不一致；所有声明均无法与源码交叉验证。因此扣除相应分数。
安装易用性 13/20: 快速开始步骤清晰：克隆仓库、npm install、在 Claude Desktop 中粘贴配置 JSON、通过 UPM 安装 companion 插件，并提供了完整的环境变量表。但安装依赖外部 Unity 插件，且没有源码或 CI 证据证明可开箱即用；部分功能仅支持 Windows（如编辑器窗口截图）。静态证据不足以支持更高分数。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码访问网络

适合谁

寻求免费开源方案、希望用 AI 控制 Unity 的独立开发者和小型工作室
想要使用 Claude、Cursor 等 MCP 兼容客户端进行游戏开发自动化的开发者
需要涵盖大量 Unity 功能的高级工具集的团队

不适合谁

需要商业官方支持或企业级保证的专业游戏公司
不希望配置环境或依赖命令行工具的初学者（需要 Node.js 18+ 和 Unity Hub）
需要在 Unity 6.2+ 内直接使用 Unity AI 原生功能的用户

所需权限

读取/修改 Unity 项目文件、创建/删除资产和脚本
执行 Unity 编辑器命令、读取控制台和编译日志
控制 Unity Hub（列出/安装编辑器），需要设置 UNITY_HUB_PATH 环境变量
通过 HTTP 桥接与 Unity 编辑器交互，默认端口 7890

风险与副作用

由于服务器可自动创建/删除资产和脚本，存在数据丢失风险；建议定期备份项目
执行 AI 生成的代码可能导致意外错误或损坏项目
需要配置环境变量（如 UNITY_HUB_PATH），配置错误可能导致连接失败
使用非官方许可证（AnkleBreaker Open License）可能限制商业再分发

安装接入

准备工作

运行环境：Node.js 18+

其他可选配置项（12 个）

UNITY_HUB_PATH 可选 Unity Hub 可执行文件路径，默认为 C:\Program Files\Unity Hub\Unity Hub.exe

UNITY_BRIDGE_HOST 可选 Unity Editor 桥接主机地址，默认 127.0.0.1

UNITY_BRIDGE_PORT 可选 Editor 桥接端口，默认 7890，多实例时自动发现

UNITY_BRIDGE_TIMEOUT 可选请求超时时间（毫秒），默认 60000

UNITY_PORT_RANGE_START 可选多实例发现端口扫描起始端口，默认 7890

UNITY_PORT_RANGE_END 可选多实例发现端口扫描结束端口，默认 7899

UNITY_REGISTRY_STALENESS_TIMEOUT 可选实例注册表过期超时（毫秒），用于崩溃检测，默认 300000

UNITY_RESPONSE_SOFT_LIMIT 可选响应大小软限制（字节），超出发出警告，默认 2097152

UNITY_RESPONSE_HARD_LIMIT 可选响应大小硬限制（字节），超出截断，默认 4194304

UNITY_MCP_DEBUG 可选设为 1 时将诊断信息写入 UnityMCP/mcp-debug.log（5MB 轮转）

UNITY_MCP_PRETTY_JSON 可选设为 1 时以格式化 JSON 输出工具响应（默认紧凑 JSON 更省 token）

UNITY_MCP_COMPACT_TOOLS 可选设为 1 时输出精简 tools/list（约 21KB），适用于有注册表大小限制的客户端

在 Unity 中安装插件：Window > Package Manager > + > Add package from git URL，输入 https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.git 2. 克隆并安装服务器：git clone https://github.com/AnkleBreaker-Studio/unity-mcp-server.git && cd unity-mcp-server && npm install 3. 将以下 JSON 配置添加到 Claude Desktop（Settings > Developer > Edit Config）：{"mcpServers":{"unity":{"command":"node","args":["C:/path/to/unity-mcp-server/src/index.js"],"env":{"UNITY_HUB_PATH":"C:\\Program Files\\Unity Hub\\Unity Hub.exe","UNITY_BRIDGE_PORT":"7890"}}}} 4. 重启 Claude Desktop

验证是否装好

在 Claude Desktop 中重启后，工具列表应出现 unity 相关核心工具（如 unity_list_instances）；输入"列出我已安装的 Unity 编辑器"，若能返回编辑器列表并连接 Unity Editor（Console 中出现 [MCP Bridge] Server started on port 7890），即安装成功。

常见排障

连接失败：确保 Unity 编辑器已打开并安装了插件；检查控制台是否显示 '[MCP Bridge] Server started on port 7890'
Unity Hub 未找到：更新配置中的 UNITY_HUB_PATH 指向正确的 Unity Hub 可执行文件
端口冲突：修改 UNITY_BRIDGE_PORT 并同步更新 Unity 的 MCP Dashboard 设置
类别被禁用：在 Unity 的 MCP Dashboard 中检查类别设置，确保所需类别已启用

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我已安装的 Unity 编辑器版本
显示当前场景的层级结构
在位置 (0, 2, 0) 创建一个红色立方体并添加 Rigidbody
为 Windows 构建我的项目

使用场景

AI 辅助游戏开发：创建场景、放置对象、编写脚本、运行构建

获取场景层级结构、查看编译错误、分析性能

编辑 Shader Graph、控制地形、烘焙 NavMesh、管理动画、运行多人测试

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

AnkleBreaker Unity MCP 服务器是用于 Unity 游戏开发的最全面的模型上下文协议 (MCP) 服务器。它通过 HTTP 桥接将 Claude、Cursor、Windsurf 等 MCP 兼容的 AI 助手连接到 Unity 编辑器和 Unity Hub。提供了 330+ 工具，覆盖 30+ 类别，包括场景管理、GameObject 操作、组件、渲染、构建、性能分析、Shader Graph、Amplify Shader Editor、地形、物理、NavMesh、动画、多人游戏、资产、脚本、测试等。采用两层工具系统：约 70 个核心工具直接暴露，其余 254 个通过 unity_advanced_tool 代理懒加载，以避免 MCP 客户端工具数量限制。支持多实例、多代理、端口恢复、崩溃检测。通过 AnkleBreaker Open License 完全免费开源，但禁止转售。