← 返回目录
U

Unity MCP Server

社区
330+ 工具,将 Claude 变成你的 Unity 编辑器与 Hub 全能副驾驶
GitHub 源仓库 ↗
★ 390 Stars 分类 · 开发工具 非常热门 源版本 826af5ce61db
50FMRS · D
可靠性
4/20
安全与权限
6/20
维护活跃度
12/20
文档质量
15/20
安装易用性
13/20

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

查看 FMRS 评分方法 →

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 完全免费开源,但禁止转售。

工具能力

暂未整理工具清单。

安装接入

  1. 在 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

选型与风险

适合谁

  • 寻求免费开源方案、希望用 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)可能限制商业再分发

常见排障

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

使用场景

AI 辅助游戏开发:创建场景、放置对象、编写脚本、运行构建
获取场景层级结构、查看编译错误、分析性能
编辑 Shader Graph、控制地形、烘焙 NavMesh、管理动画、运行多人测试

支持客户端

Claude Desktop完整支持