UnityMCP

基本能力

产品定位

UnityMCP 是一个 Unity 编辑器插件，旨在通过 MCP 协议实现 Unity 编辑器与 AI 助手之间的高效交互，提升开发效率。

核心功能

1. 实时编辑器状态监控
2. 获取当前 Unity 编辑器状态
3. 包括活动 GameObject、选择状态、播放模式状态等

4. 提供场景层次结构和项目结构

5. 远程命令执行

6. 直接在 Unity 编辑器中执行 C# 代码
7. 完全访问 UnityEngine 和 UnityEditor API

8. 实时执行和全面的错误处理

9. 日志记录系统

10. 检索和过滤 Unity 编辑器日志
11. 支持按类型、内容和时间戳过滤
12. 可定制的输出字段

适用场景

• Unity 开发过程中的自动化任务
• AI 辅助的 Unity 开发
• 远程控制和监控 Unity 编辑器

工具列表

1. get_editor_state
2. 获取当前 Unity 编辑器状态

3. 支持不同输出格式

4. execute_editor_command

5. 在 Unity 编辑器中执行 C# 代码

6. 提供全面的错误处理和超时保护

7. get_logs

8. 检索和过滤 Unity 编辑器日志
9. 支持多种过滤条件

常见问题解答

• 连接问题：确保服务器运行在端口 8080 上
• 命令执行失败：检查代码语法和权限
• 超时问题：优化复杂命令的执行时间

使用教程

使用依赖

• Unity 2022.3 或更高版本
• Node.js 18 或更高版本
• npm 9 或更高版本

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @Arodoid/unitymcp --client claude

Unity 插件设置

1. 将 UnityMCPPlugin 文件夹复制到 Unity 项目的 Assets 目录
2. 打开 Unity 编辑器
3. 通过 Unity 顶部菜单栏 > UnityMCP > Debug Window 访问插件

MCP 服务器设置

cd unity-mcp-server
npm install
npm run build

调试方式

启动服务器

cd unity-mcp-server
node build/index.js

从 Unity 连接

1. 打开 Unity 项目
2. 打开 UnityMCP 调试窗口 (Window > UnityMCP > Debug Window)
3. 插件将自动尝试连接到 MCP 服务器
4. 在调试窗口中监控连接状态和日志

示例命令

// 居中选中的对象
Selection.activeGameObject.transform.position = Vector3.zero;

// 切换播放模式
EditorApplication.isPlaying = !EditorApplication.isPlaying;

// 创建新立方体
GameObject.CreatePrimitive(PrimitiveType.Cube);

许可证

该项目遵循 Other 开源许可条款，请参阅 Other 了解完整条款。