# Unity MCP + Codex CLI 完整教程（Windows）

下面给你一篇真正能跑通的：

Unity MCP + Codex CLI 完整教程（Windows）

包含：

MCP 原理
Unity MCP 安装
uv 安装
Codex CLI 配置
多 Unity 项目
MCP 工作原理
你刚刚踩过的坑
常见报错
多 Agent 思想
后续能扩展什么

这是目前真正 AI Agent + Unity 开发的核心方向。

一、MCP 到底是什么？

MCP 全称：

text 复制代码

Model Context Protocol

本质：

text 复制代码

AI 和 外部软件之间的通信协议

你可以把它理解成：

text 复制代码

AI 的 USB 接口

以前 AI：

只能聊天
只能生成代码

现在：

通过 MCP：

AI 可以真正操作软件。

例如：

Unity
VSCode
Git
Chrome
Blender
Photoshop
数据库

等等。

二、你现在跑通的架构

你现在已经成功进入：

text 复制代码

Codex CLI
    ↓
MCP Client
    ↓ HTTP/WebSocket
Unity MCP Server
    ↓
Unity Editor API

。

也就是说：

text 复制代码

AI 已经可以真正操作 Unity

了。

三、Unity MCP 能做什么？

目前主流功能：

功能	示例
场景操作	创建对象
Console	读取报错
GameObject	查找/修改
Prefab	创建
Script	生成代码
PlayMode	运行游戏
Asset	查资源
Menu	执行菜单命令

未来：

Shader Graph
Timeline
Animator
Addressables
UI自动生成

都会逐渐接入。

四、安装 Unity MCP

你使用的是：

CoplayDev/unity-mcp

这是目前最火的 Unity MCP 项目之一。

五、安装步骤（Windows）

1. 安装 Unity MCP 插件

Unity：

text 复制代码

Window > Package Manager

或者：

text 复制代码

Window > MCP For Unity

安装插件。

成功后会出现：

text 复制代码

MCP For Unity

窗口。

2. 安装 uv

MCP Server 底层依赖：

text 复制代码

uv

它是 Python 的高速包管理/运行器。

PowerShell：

powershell 复制代码

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装后：

powershell 复制代码

uv --version

验证。

例如：

text 复制代码

0.11.16

。

六、你遇到的第一个大坑

你点击：

text 复制代码

Start Server

后。

出现：

text 复制代码

error: unexpected argument '--from' found

。

原因

Unity MCP 插件生成了错误命令：

错误：

powershell 复制代码

uv.exe --from ...

。

但：

text 复制代码

--from

实际上是：

text 复制代码

uvx

的参数。

正确命令

应该是：

powershell 复制代码

uvx --from ...

。

七、正确启动 Unity MCP

你最终成功的命令：

powershell 复制代码

C:\Users\Administrator\.local\bin\uvx.exe --from mcpforunityserver==9.7.1 mcp-for-unity --transport http --http-url http://127.0.0.1:8080 --project-scope-tools

。

八、第二个坑：uvx 路径错误

你最开始用了：

text 复制代码

C:\Users\Administrator\.dotnet\tools\uvx.exe

。

但：

text 复制代码

路径不存在

。

因为实际安装目录是：

text 复制代码

C:\Users\Administrator\.local\bin

。

九、验证 MCP 是否启动成功

成功后：

Unity 面板：

text 复制代码

No Session

会变成：

text 复制代码

Connected

或者：

text 复制代码

Session Active

。

并且：

PowerShell 不会退出。

这个窗口：

text 复制代码

不能关闭

。

因为：

text 复制代码

它就是 MCP Server 进程

。

十、配置 Codex CLI

配置文件：

text 复制代码

C:\Users\Administrator\.codex\config.toml

。

加入：

toml 复制代码

[mcp_servers.unityMCP]
url = "http://127.0.0.1:8080/mcp"
startup_timeout_sec = 10
tool_timeout_sec = 60

。

十一、第三个坑：duplicate key

你遇到：

text 复制代码

duplicate key

。

原因：

toml 复制代码

[mcp_servers.unityMCP]

写了两次。

正确做法

只能保留一个：

toml 复制代码

[mcp_servers.unityMCP]
url = "http://127.0.0.1:8080/mcp"

。

十二、localhost 和 127.0.0.1 的区别

你问：

toml 复制代码

localhost

和：

toml 复制代码

127.0.0.1

有什么区别。

本质

其实：

text 复制代码

localhost -> 127.0.0.1

。

但：

text 复制代码

localhost

有时会解析成：

text 复制代码

::1

（IPv6）

。

而：

text 复制代码

127.0.0.1

是固定 IPv4。

MCP 推荐

建议统一：

toml 复制代码

url = "http://127.0.0.1:8080/mcp"

。

更稳定。

十三、如何测试 Codex 是否连接成功

重启：

bash 复制代码

codex

。

然后输入：

text 复制代码

列出当前 Unity MCP 工具

。

成功后：

Codex 会返回：

manage_scene
manage_gameobject
read_console
manage_asset

等等。

十四、多个 Unity 项目怎么办？

这是你问得非常关键的问题。

一个端口 = 一个 Unity MCP

例如：

text 复制代码

127.0.0.1:8080

只能对应：

text 复制代码

一个 Unity 项目

。

三个 Unity 项目同时开

必须：

text 复制代码

不同端口

。

例如：

项目	端口
项目A	8080
项目B	8081
项目C	8082

。

Codex 配置

toml 复制代码

[mcp_servers.projectA]
url = "http://127.0.0.1:8080/mcp"

[mcp_servers.projectB]
url = "http://127.0.0.1:8081/mcp"

[mcp_servers.projectC]
url = "http://127.0.0.1:8082/mcp"

。

Codex 如何区分？

你需要明确告诉它：

text 复制代码

操作 projectB

。

否则：

AI 不知道你要控制哪个 Unity。

十五、MCP 的真正意义

你现在其实已经进入：

text 复制代码

Agentic Workflow

时代。

传统开发

text 复制代码

人
 ↓
手动操作Unity

。

MCP + Agent 开发

text 复制代码

人
 ↓
AI Agent
 ↓
MCP
 ↓
Unity

。

十六、未来会发生什么？

未来：

你可能只说：

text 复制代码

帮我做一个割草游戏

。

AI：

创建工程
导入资源
创建场景
写代码
配 Animator
修 Console Error
打包 APK

。

这也是：

OpenAI
Anthropic
Cursor
Devin
OpenHands

现在疯狂投入的方向。

十七、你下一步建议

你现在已经跑通基础版。

下一步建议：

第一阶段

先熟悉：

text 复制代码

Codex -> MCP -> Unity

调用逻辑。

例如：

创建对象
查 Console
获取Hierarchy

。

第二阶段

开始接：

VSCode MCP
Git MCP
Browser MCP

。

第三阶段

开始：

text 复制代码

多Agent工作流

。

例如：

Agent	职责
Unity Agent	改场景
Code Agent	写代码
Debug Agent	修Bug
Git Agent	提交PR

。

十八、你现在已经不是"AI聊天"

而是：

text 复制代码

AI操作系统

阶段了。

这是整个 AI 开发行业正在发生的巨大变化。