连接 MCP 客户端（如 Claude、Cursor）与 Unity 编辑器的双向桥接工具，支持 AI 操控场景、对象与脚本。
Unity MCP 是一个基于 C# 与 Python 的双端架构工具，通过模型上下文协议（MCP）实现 AI 编程助手与 Unity 编辑器的直接交互。
核心架构#
采用双层架构设计：
- Unity Editor 端：C# 实现的 TCP 服务器，监听端口 6400，使用
[InitializeOnLoad]自动启动桥接服务 - Python 端：基于 FastMCP 框架的 MCP 服务器，通过 stdio 与 AI 客户端通信，通过 TCP 连接 Unity
主要功能#
Editor 控制#
- 执行编辑器动作：PLAY, PAUSE, STOP, BUILD, SAVE
- 读取和过滤 Unity Console 日志
场景管理#
- 获取场景列表、当前场景信息
- 打开/保存/创建/切换场景
对象管理#
- 创建/删除对象（Cube, Sphere, Camera, Empty 等）
- 设置 Transform 位置/旋转/缩放
- 添加/移除组件
- 按名称查找对象、获取层级结构
脚本管理#
- 创建/查看/更新脚本文件
- 附加脚本到游戏对象
- 支持自定义命名空间和模板
资产与材质#
- 导入资产、实例化/创建/应用 Prefab
- 设置对象材质，支持 RGB 颜色参数
- 获取项目资产列表
环境要求#
- Unity 2022.3+
- Python >=3.12
- 依赖：httpx>=0.28.1, mcp[cli]>=1.4.1
安装部署#
- 通过 Unity Package Manager 导入包
com.justinpbarnett.unity-mcp - 安装 Python 依赖：
pip install httpx mcp[cli]或uv sync - 启动 Python 服务器：
python Python/server.py - 配置 MCP 客户端连接
扩展开发#
支持自定义工具添加：在 C# 端注册命令处理器，在 Python 端使用 @mcp.tool() 装饰器定义工具函数。