开发工具 · MCP 适配器
Codely Unity MCP
让 AI Agent 在写代码之外,也能查询团结工程中的对象、组件与场景,调用编辑器操作并检查结果。项目复用已有 Codely Bridge,通过一套 MCP 接口把编辑器能力提供给支持本地 MCP stdio 的客户端。
- 适配器
- Node.js · MCP stdio
- 编辑器通信
- 复用 Codely Bridge
- 能力来源
- Bridge 版本与状态
使用场景
检查游戏问题,需要看到编辑器中的实际状态
脚本文件之外,对象挂载了什么组件、场景如何配置、Console 是否报错,同样影响游戏行为。当 Agent 只能阅读代码时,开发者还需要提供编辑器里的对象信息与运行状态。这个适配器提供直接查询和调用的工具入口,让 Agent 可以结合源码与编辑器返回的信息继续检查。
检查流程
以 Player 的重复组件检查为例
仓库 README 展示了这一使用案例:从连接确认、对象查询到 C# 核对,按顺序获取检查依据。- 确认连接和状态检查目标工程、Bridge 与编辑器是否就绪
- 读取对象与组件查询 Player 实际挂载的组件信息
- 结合 C# 检查将对象查询与代码检查结果交叉核对
- 说明检查依据根据返回信息报告发现,必要时再读取 Console
这条流程的作用是把判断依据落到编辑器返回的信息上。只读检查与修改操作分别处理;需要更改对象、场景或资源时,仍须满足当前 Bridge 的状态与写保护要求。
连接架构
Agent、适配器、Bridge 与编辑器
适配器将标准 MCP 请求转成 Bridge 命令,并通过工程连接信息发现本机通信端口。
Codely Unity MCP 架构
多个 Agent 通过 MCP stdio 接入适配器,再经本地 TCP 连接现有 Codely Bridge 与团结编辑器。图中 Agent 名称是接入方式示意,兼容能力仍以客户端支持为准。
图片来自公开仓库 README 的 docs/images/architecture.png;本网站复制自项目文档。
复用 Bridge 的连接方式
对比自建编辑器通信插件与复用 Codely Bridge 的链路。图中注明这是架构差异示意,不代表所有 Unity MCP 都采用相同实现。
图片来自公开仓库 README 的 docs/images/bridge-comparison.png;本网站复制自项目文档。复用已有 Bridge,专注 MCP 适配
本项目实现工具定义、命令转换与连接处理。编辑器内部的操作由 Codely Bridge 提供,已经安装 Bridge 的工程可以沿用现有通信组件。
按目标工程发现连接
适配器读取指定工程的握手文件发现 TCP 端口;编辑器重启、端口变化后,后续请求可重新发现并连接。Doctor 用于检查路径、握手文件和连接状态。
工具入口与操作指引配合
MCP 暴露能力,配套 Skill 指导 Agent 在操作前检查编辑器状态、遵守写保护,并在操作后读取 Console 和复核结果。
工具能力
12 个工具覆盖常见编辑器工作
适配器提供命令入口,具体动作仍由已安装的 Bridge 实际支持。连接与编辑器状态
检查连接、编辑器状态及 Play / Stop 操作。
bridge_status · manage_editor对象与组件
查询、创建和修改 GameObject、组件及属性。
manage_gameobject场景与资源
查询并管理场景、加载保存操作与项目资源。
manage_scene · manage_assetC# 与 Console
执行 C# 片段,读取或清理 Console 信息。
execute_csharp · read_console截图与异步任务
调用 Bridge 支持的截图或录制能力,检查异步任务状态。
screenshot · manage_job视图与扩展命令
管理 Game View、调用菜单命令或转发其他 Bridge 命令。
manage_gameview · execute_menu_item · send_raw工具范围包括连接与编辑器状态、GameObject 和组件、场景、资源、C#、Console、截图、Game View、菜单命令及异步任务。部分编辑器写操作会受到 Play 状态和 Bridge 写保护限制;工具调用前应检查连接与状态,完成后再读取 Console 验证结果。
当前进展
已记录的验证与使用范围
12 个工具是接口范围;实际可用动作还取决于 Bridge 版本、编辑器状态与写保护。README 中记录的只读端到端检查:团结 2022.3.62t13 与 Codely Bridge 1.0.81,检查 Bridge 状态和编辑器状态。
仓库也记录了模拟 Bridge 下的协议、握手失败、连接拒绝与端口变化重连测试。其他 Unity 版本、客户端与 Bridge 版本的完整兼容性尚未验证。
安装与源码
先准备编辑器中的 Codely Bridge
安装方式、MCP 客户端配置与配套 Skill 说明见公开仓库 README。准备好已安装 Codely Bridge 的团结工程后,可按仓库 README 配置 MCP 客户端,先运行 Doctor,再读取 Bridge 和编辑器状态。配套 Skill 需要另行安装。Bridge 为独立组件,本项目不代表团结或 Codely 官方。