# MCP 工具

Codex 通过本地 Node MCP Server 与 Unity Editor Bridge 交互。该实现不绑定具体游戏工程，当前已在 `FFCard_WeChat` 验证。

## 实现位置

- MCP Server：`UnityAI/Tools/CodexUnityMcp/`
- Unity Editor Bridge：目标项目 `Assets/Editor/Command/`
- Codex 配置：工作区 `.codex/config.toml`
- 本地地址：`http://127.0.0.1:17777`

## 能力

- Unity 健康检查
- AssetDatabase 刷新
- 白名单菜单执行
- Console 日志读取
- UI JSON 生成 Prefab
- Prefab 导出 JSON

具体调用、UI 前置阅读、安全边界和排错见 [Codex 与 Unity MCP 使用规则](Codex_Unity_MCP使用规则.md)。

推荐顺序：`unity_health` → 修改文件 → `unity_refresh_assets` → 重连并再次健康检查 → 执行白名单菜单 → `unity_get_console_logs`。刷新触发编译时 Bridge 会暂时断连；菜单超时表示结果未知，确认日志和资产状态前不要重复执行。

## 文档关联

| 文档 | 关联原因 |
|---|---|
| [编辑器工具入口](../README.md) | 编辑器工具模块入口 |
| [MCP 使用规则](Codex_Unity_MCP使用规则.md) | 具体调用规范 |
| [MCP Server README](../../../../Tools/CodexUnityMcp/README.md) | 安装和实现 |
| [模块索引](../../../模块索引.md) | 模块状态 |
| [工作流清单](../../../../rules/40-工作流清单.md) | Unity 自动化验证步骤 |