首页 / 创作工具连接器 / MCP for Unity(unity-mcp)

MCP for Unity(unity-mcp)

MCP for Unity(unity-mcp)是CoplayDev / Aura(社区,非 Unity 官方)社区提供的MCP 连接器(MCP 服务器),用自然语言让智能体搭场景、建 GameObject、写改 C# 脚本、管理资源、跑测试和出包,MIT 协议免费使用。

MCP个人可用国内网络:可直接用社区开源

能帮你做什么

MCP for Unity 是 MIT 协议的开源项目,由 CoplayDev 维护、Aura 赞助。项目自己写明它与 Unity Technologies 没有隶属关系,不是 Unity 官方出品。它在 Unity 编辑器里装一个包,再在本机起一个 MCP 服务,让 Claude Code、Cursor 等智能体直接操作你打开的 Unity 工程。

能做什么

  • 用一句话搭场景、创建和修改 GameObject
  • 编写、修改 C# 脚本,调材质和着色器
  • 管理工程资源,运行测试、做性能分析、打包出包
  • 官方说明共有约 50 个 MCP 工具入口,并按特效、动画、UI、测试等分组;同时开多个 Unity 编辑器时,可以指定操作哪一个实例

适合谁

想用智能体辅助做独立游戏、交互 Demo、3D 展示项目的个人开发者。项目提供了简体中文 README,上手门槛相对低。

注意事项

  • 这是社区项目,同名的 Aura for Unity 是另外的付费产品,不要混淆。
  • 智能体可以直接改脚本和场景,重要工程请先用 Git 备份。
  • 列出的智能体中,只有 Claude Code、Cursor 等在项目文档中被点名;国内智能体按其支持自定义 MCP 的能力列出,在智能体连接器(lianjieqi.ai)尚未实测。

安装方法

通用 MCP 配置(来自官方文档,把占位符换成你自己的 Key / 路径):

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

按智能体查看步骤。标 ★ 的是官方文档明确列出的客户端;其余按该智能体的通用 MCP 接入方式整理,本站尚未逐一实测。

豆包工作 字节跳动
  1. 打开豆包工作客户端,点击左侧「插件·技能·伙伴」,进入「插件」页面。
  2. 官方或企业插件:点击目标插件右侧的「连接」,在弹窗中完成授权。
  3. 自定义:点击「插件」页面右上角「+ 添加」→「新建自定义连接器」。
  4. 远程服务选择 HTTP 类型,填写服务器 URL,需要鉴权时在「自定义 Headers」里添加请求头。
  5. 本地程序选择 STDIO 类型,填写运行命令(如 npx)、参数和环境变量后保存。
  6. 在任务对话框输入 / 或 @ 选择插件,或直接描述需求由系统自动匹配。

配置内容使用上方的通用 MCP 配置。

查看 豆包工作 完整指南 →

TRAE 字节跳动
  1. 在 IDE 窗口或 Agent 窗口中,前往「设置 → MCP」。
  2. 点击右上角「添加 → 从市场添加」,在内置 MCP 市场里点「+」并填写 Key 等配置;或选择「添加 → 手动添加」。
  3. 手动添加时,把下方 JSON 配置粘贴到「手动配置」窗口,点击「确认」。
  4. 项目级配置:先在设置中打开「项目级 MCP」开关,再在项目根目录 .trae/mcp.json 中写入配置。

配置内容使用上方的通用 MCP 配置。

查看 TRAE 完整指南 →

CodeBuddy 腾讯云
  1. 打开(或新建)用户级配置文件 ~/.codebuddy/.mcp.json;只想在某个项目里用,就写到项目根目录的 .mcp.json。
  2. 在 mcpServers 下加入下方配置,远程服务可加 "type": "http",本地命令可加 "type": "stdio"。
  3. 也可以把配置保存成文件,用 codebuddy --mcp-config ./mcp.json 启动时加载。
  4. 重新启动 CodeBuddy 会话后即可调用。

配置内容使用上方的通用 MCP 配置。

查看 CodeBuddy 完整指南 →

Kimi Code 月之暗面
  1. 在 Kimi Code CLI 的终端界面中运行 /mcp-config,交互式新增 MCP Server;或手动编辑 ~/.kimi-code/mcp.json。
  2. 把下方配置写进 mcpServers:含 command 字段的是 stdio,含 url 字段的是 HTTP;旧式 SSE 需加 "transport": "sse"。
  3. 需要 OAuth 的服务运行 /mcp-config login 完成浏览器授权。
  4. 运行 /mcp 查看连接状态;新增的服务只会加入之后新建的会话。

配置内容使用上方的通用 MCP 配置。

查看 Kimi Code 完整指南 →

★ Cursor Anysphere(海外)
  1. 安装 uv,并确认终端里 uv --version 能正常输出。
  2. 打开 Unity → Window → Package Manager → 左上角「+」→ Add package from git URL,填入 https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main。
  3. 在 Unity 菜单 Window → MCP for Unity 中点击 Configure All Detected Clients,自动写入已检测到的客户端配置。
  4. 自动配置不生效时,把下方 JSON 手动写入 ~/.cursor/mcp.json,然后对智能体说“在原点放一个立方体,加个 Rigidbody”试试。
项目 README 还给出了 stdio 方式:command 为 uvx,args 为 --from mcpforunityserver mcp-for-unity --transport stdio,适合只支持本地命令的客户端。

查看 Cursor 完整指南 →

★ Claude Code Anthropic(海外)
  1. 远程服务:claude mcp add --transport http <名称> <URL>
  2. 本地命令:claude mcp add --transport stdio <名称> -- npx <包名>(-- 之后是服务自己的命令和参数)
  3. 需要环境变量时加 --env KEY=value;想在所有项目可用时加 --scope user。

配置内容使用上方的通用 MCP 配置。

查看 Claude Code 完整指南 →

MCP for Unity(unity-mcp) 常见问题

MCP for Unity(unity-mcp)是什么?

MCP for Unity(unity-mcp)是CoplayDev / Aura(社区,非 Unity 官方)社区提供的MCP 连接器(MCP 服务器),用自然语言让智能体搭场景、建 GameObject、写改 C# 脚本、管理资源、跑测试和出包,MIT 协议免费使用。

MCP for Unity(unity-mcp)个人能用吗?收费吗?

个人可用。使用门槛:本机安装 Unity 2021.3 LTS 至 6.x,以及 Python 3.10+ 与 uv;在 Unity Package Manager 中从 git URL 安装 MCP for Unity 包。

MCP for Unity(unity-mcp)在国内网络能直接用吗?

可直接用。MCP 服务在本机运行(默认 http://localhost:8080/mcp),通过 Unity 编辑器里的插件操作本机工程,核心功能不依赖海外服务(资料推断,本站未实测)。首次安装需从 GitHub 拉取 Unity 包、从 PyPI 下载服务端,国内网络下载速度待实测。

哪些智能体可以使用MCP for Unity(unity-mcp)?

本站整理了 豆包工作、TRAE、CodeBuddy、Kimi Code、Cursor、Claude Code 的安装方法,其中 Cursor、Claude Code 为官方文档明确列出的客户端。

MCP for Unity(unity-mcp)的信息来源是什么?

本页依据 GitHub:CoplayDev/unity-mcp README;GitHub:CoplayDev/unity-mcp 简体中文 README;MCP for Unity 文档:工具目录 整理,最后核对于 2026-11-20。

官方来源

本页由智能体连接器(lianjieqi.ai)整理,依据以上公开来源原创撰写,最后核对于 2026-11-20(资料核对)。服务方可能随时调整,请以官方最新说明为准。