Windows 下在 Trae 中接入 Unity-MCP:实现 AI 像 Coding 一样控制 Unity Editor(完整避坑指南)
关键词:Unity-MCP、Trae、MCP、Unity Editor、AI 辅助开发、Hierarchy 自动化、Windows
一、背景与目标
随着 MCP(Model Context Protocol)的出现,AI 已经不再局限于生成代码文本,而是可以直接操作真实开发环境。
本文的目标是:
在 Windows 环境下,将 Trae 作为 MCP Client,成功接入 Unity-MCP,使 AI 能同时:修改 / 新增 C# 脚本直接操作 Unity Hierarchy(创建 / 修改 GameObject)像 Coding 一样具备“可控、可回滚”的工作流
本文完整记录了 从 0 到成功连接 的全过程,并重点解决官方教程中最容易踩坑的部分。
二、整体技术架构(先建立正确认知)
在开始之前,先明确三点(非常重要):
- Unity-MCP 在 Unity 内部运行,是 MCP Server
- Trae 是 MCP Client
- 两者通过 HTTP +
/mcpendpoint 通信
最终结构是:
Trae (MCP Client) │ │ JSON-RPC over HTTP ▼ http://localhost:8080/mcp │ Unity-MCP (Server, running inside Unity Editor) │ Unity Editor API(Hierarchy / Scripts / Assets) 👉 这意味着:
- Trae 不需要启动 Server
- 只需要“连接”到 Unity 提供的 MCP endpoint
三、环境准备(Windows)
1️⃣ Python(必须 ≥ 3.10)
Unity-MCP 对 Python 版本有要求:
- ✅ Python 3.10+
- ❌ Anaconda 默认 Pyth