unity-mcp-server
AnkleBreaker-Studio/unity-mcp-server加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
你有没有想过，对着聊天窗口说一句话，Unity编辑器就能自动帮你创建3D场景、调整光照、运行Profiler性能分析？AnkleBreaker Unity MCP 就是这样一款工具——它用 Model Context Protocol（MCP）把主流AI助手与Unity编辑器直接连通，让"用嘴写游戏"从概念变成可落地的开发流程。
Unity 是全球最流行的游戏引擎之一，在中国也拥有庞大的开发者群体。但即便有再强大的编辑器，机械性的重复操作始终是拖慢开发效率的隐形杀手：建一个测试场景要手点十几次菜单，改一个Shader参数要翻三级子窗口，调试性能要同时盯着Profiler和Console来回切换。这些操作本身不需要创意，却占据了开发者大量宝贵时间。
随着 Claude、Cursor、Windsurf 等AI编程工具的崛起，社区一直在探索：能否让AI直接操控Unity编辑器？AnkleBreaker Studio 正是这一方向的先行者。他们从2024年开始开发 Unity MCP Server，目标只有一个——让AI成为Unity的"超级驾驶员"，而不是只会生成代码片段的剪贴板。
这是目前已知最完整的 Unity + MCP 集成方案。项目将工具分为核心工具（约70个，始终暴露）和高级工具（约260个，通过统一代理访问），覆盖30多个功能类别：
| 类别 | 核心能力 |
|---|---|
| 场景与GameObject | 创建、删除、复制、层级管理、Transform控制 |
| 资产与Prefabs | 导入、搜索、创建材质和预制体 |
| 脚本管理 | 读取、新建、编辑 C# 脚本 |
| 多平台构建 | Windows/macOS/Linux/Android/iOS/WebGL |
| Shader Graph & Amplify | 节点操作、属性设置、图形化shader创建 |
| 地形系统 | 雕刻、绘制高度图/纹理、管理树木和细节 |
| 导航与寻路 | NavMesh烘焙、Agent配置、离网链接 |
| Profiler & Frame Debugger | 性能分析、内存快照、渲染调试 |
| 动画系统 | 动画剪辑、控制器、参数控制 |
| 粒子系统 | 创建、检查、模块化粒子特效 |
| 光照与反射 | 灯光管理、环境光、天空盒、光照图烘焙 |
| 物理系统 | Raycast、Sphere/Box Cast、Overlap测试 |
| MPPM多人游戏 | 多人PlayMode场景管理、玩家信息 |
| UMA角色系统 | 角色创建、换装、Global Library管理 |
双层工具架构的设计非常巧妙：MCP客户端（如Claude Desktop）在工具数量过多时会静默失败，该项目通过两级分装——始终暴露核心工具，高级工具通过 unity_advanced_tool 统一代理——既保证AI能发现所有功能，又不会撑爆MCP协议的消息体（曾有测试显示268个工具的响应体达125KB，超过安全限制）。
整体架构为四层：
Claude / AI助手 ←→ MCP Server (Node.js) ←→ Unity Editor Plugin (HTTP API) ←→ Unity Editor
↕
Unity Hub CLI
MCP Server 基于 @modelcontextprotocol/sdk 构建，通过标准输入/输出（stdio）与AI客户端通信。核心依赖只有一个——@modelcontextprotocol/sdk ^1.0.0，代码总规模约10万行量级（以index.js等核心文件为主）。
Unity Editor Plugin（独立仓库 unity-mcp-plugin）运行在Unity编辑器内部，提供HTTP API接口。这种设计有几个关键优势：
instances.json）+ 端口扫描（7890-7899），自动发现并管理多个同时运行的Unity Editor实例安装分三步：
https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.gitgit clone 后 npm install（依赖只有1个SDK包）node /path/to/unity-mcp-server/src/index.js安装完成后，对话示例：
项目采用 AnkleBreaker Open License v1.0（自定义开源许可），非标准许可可能对商业项目有使用限制，购买商业授权需联系 AnkleBreaker Consulting。
截至分析时项目约350+ Stars，版本 v2.35.6，持续活跃维护中。Topics 标签包含 mcp-server、unity-editor、claude-desktop、ai-assisted-development 等，反映其明确的AI+游戏开发定位。
需要Unity Plugin配合：Server本身只是通信中枢，必须同步安装 unity-mcp-plugin 才能工作，增加了部署复杂度。
特定AI平台绑定：依赖 Claude Desktop、Cowork、Cursor 等支持 MCP 协议的工具，非MCP客户端无法使用。
许可证不确定性：自定义开源许可而非标准的MIT/Apache/GPL，在商业场景中使用前需仔细审查许可条款。
多Agent场景下的稳定性：虽然代码层面实现了Agent隔离，但多个AI Agent同时操控同一Unity编辑器时仍可能出现竞争条件，高级多人协作场景需要更多测试验证。
AnkleBreaker Unity MCP 代表了 AI + 游戏引擎深度集成的一个方向：不是替代Unity，而是给Unity配备一个AI副驾驶。随着 Claude Code、Cowork 等工具在编程领域的渗透，游戏开发作为对视觉化和实时性要求最高的领域之一，AI与编辑器的直连将成为下一代工作流的标准配置。该项目的工具覆盖度和架构设计（HTTP桥接、多实例、多Agent隔离）展现了扎实的工程能力，也为其他引擎（Unreal、Godot）的MCP集成提供了参考范式。