Unity MCP:让 Claude 直接操作 Unity 编辑器

"建对象、连组件、写脚本,一句话说完就帮你做完"——CoplayDev 的开源 MCP for Unity 是 AI 与主流引擎深度结合的代表作,而且是本地运行:代码不出你的机器。

本文依据

基于 DeepWiki 对 CoplayDev/unity-mcp(约 1.6 万星)的源码级分析整理。架构、工具目录与安装要求均来自官方文档。

它是什么、怎么连

MCP for Unity 是一个开源桥接器:让 Claude Code、Cursor 等 AI 助手通过 Model Context Protocol 直接操作 Unity 编辑器。链路是——AI 客户端发出 MCP 请求 → Python MCP 服务器 → 转发给 Unity Editor 包 → 通过 Unity Editor API 执行。支持两种连接方式:HTTP(Unity 用 WebSocket 连服务器)与 stdio(本地 TCP 桥接)。

安装两步:①通过 Package Manager 的 Git URL(或 OpenUPM)装 Unity 包;②打开 Window → MCP for Unity,用 Auto-Setup 自动配置检测到的客户端(也可手动注册 Claude Code / 配置 Cursor)。前置要求:Unity 2021.3 LTS 及以上、Python 3.10+、uv/uvx。

本地运行,代码不出门

默认 HTTP 配置走 localhost,stdio 配置用 uvx 本地启动——AI 在你自己的项目里干活,权限握在自己手上,不用把代码传到任何第三方。Docker 与远程 HTTP 托管是可选项,不是必需。

工具目录:47 个入口

工具能做什么
manage_gameobject创建、修改、变换、删除 GameObject
manage_components添加/移除组件、设置组件属性
manage_scene加载、保存场景,查询层级结构
create_script / script_apply_edits / validate_script创建 C# 脚本、应用编辑、编译校验
其余工具组资产、预制体、材质、物理、测试、构建等

文档化的工作流细节很讲究:等 Unity 的导入/编译完成、检查 Console 无报错之后,才把新脚本挂到 GameObject 上——这就是"AI 改完代码立刻能玩"的技术保障。

与 AI 工作室生态的关系

坑位清单

↑