MCP for Unity Server · Unity 编辑器 AI 控制桥

技能简介

mcpforunityserver 是为 Unity 引擎量身打造的 MCP（Model Context Protocol）服务器，让 AI 助手（Claude、Cursor、VS Code + Cline 等）通过自然语言直接控制 Unity Editor——创建对象、修改场景、调整组件、运行测试、操作资产，全部由 AI 触发但又在 Unity 中实时呈现。配套需要在 Unity 中安装官方 Unity MCP Plugin（CoplayDev/unity-mcp），二者协同构成完整的 AI × Unity 工作流。

服务器由 Coplay 团队维护（非 Unity 官方），已发布到 v10.3.0，提供 PyPI、GitHub 源码、Docker 镜像、本地开发四种部署形态，支持 stdio 与 HTTP 两种传输；HTTP 模式还内置远程托管身份验证与 Unity session 隔离，便于团队 / 云端协作。

核心能力

• 自然语言控制 Unity Editor：用 Claude / Cursor 对话即可创建对象、修改 Transform、调整 Material、控制场景
• 四大部署形态：PyPI（uvx 一行启动）/ GitHub 源码 / Docker 镜像（msanatan/mcp-for-unity-server）/ 本地开发
• 双传输协议：stdio（本地首选）+ HTTP（远程 + 云端协作）
• 远程托管安全：API Key 鉴权、Unity session 隔离、CLI-only HTTP 路由隔离、强制 Unity 实例选择
• PyPI Badge 集成：与 Unity MCP Plugin 互通，Editor 启动后自动发现并连接
• 活跃社区：官方 Discord 服务器 + 完整文档站 + CHANGELOG 持续更新
• MIT 许可：可商用、可二次开发

安装配置

1. 在 Unity 中安装 MCP Plugin（必需前置）：

• 下载 unity-mcp Unity 包并导入项目，或通过 Package Manager 从 Git URL https://github.com/CoplayDev/unity-mcp.git 安装

2. 安装 Python 服务器（PyPI 推荐方式）：

   # 安装 uv（如未安装）
   curl -LsSf https://astral.sh/uv/install.sh | sh
   # 启动 stdio 模式
   uvx --from mcpforunityserver mcp-for-unity --transport stdio

3. MCP 客户端配置（HTTP 模式）：

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

使用步骤

1. 安装前置依赖：确保系统已装 uvx（来自 uv 工具链）与 Unity 2021+
2. 启动 Unity Editor：打开已安装 MCP Plugin 的项目，Plugin 自动注册
3. 启动 MCP 服务器：按上面"安装配置"启动 stdio 或 HTTP 模式
4. 配置 MCP 客户端：在 Claude Desktop / Cursor / Cline 中加入 mcp-for-unity 条目
5. 下达自然语言指令：例如"在场景里创建 5 个 Cube，沿 X 轴排列，颜色随机"
6. 查看 Unity 反馈：Editor 实时响应 AI 操作，Unity Console 输出执行日志
7. 远程团队协作（可选）：以 --http-remote-hosted 启动，配置 API Key 服务，跨网络多人协作

适用场景

• 独立游戏开发：用 Claude 加速场景搭建、Prefab 生成、材质调优
• 关卡设计：AI 根据需求自动摆放 NPC / 道具 / 触发器
• 测试自动化：让 Agent 自动跑 PlayMode 测试、收集日志、记录性能
• 资产批处理：批量重命名、规范命名空间、按规则调整 Texture 导入设置
• 教学演示：新手用自然语言提问，让 Claude 在 Unity 中实时演示 API 用法
• 团队协作：远程办公场景下，多人通过 HTTP 共享一个 Unity Editor 实例

适用人群

• Unity 游戏开发者（独立 / 工作室均可）
• 关卡 / 技术美术 / 工具程序员
• 游戏测试工程师（希望自动跑 PlayMode 测试）
• 教学场景的 Unity 讲师与学生
• 用 LLM 加速工作流的数字艺术家

工作原理

服务器以 stdio 或 HTTP 暴露 MCP 工具集，每个工具对应一个 Unity Editor API 包装（如 create_gameobject、set_transform、add_component）。当 MCP 客户端（Claude 等）调用工具时，服务器通过 HTTP / WebSocket 把指令转发给运行在 Unity Editor 内的 MCP Plugin，Plugin 调用 UnityEngine API 执行实际操作并将结果回传。HTTP 远程模式下，服务器额外验证 API Key、按用户隔离 Unity session，避免跨用户串扰。

官方链接

• PyPI：https://pypi.org/project/mcpforunityserver/
• GitHub：https://github.com/CoplayDev/unity-mcp
• 文档站：https://coplaydev.github.io/unity-mcp/
• Docker 镜像：https://hub.docker.com/r/msanatan/mcp-for-unity-server
• Discord：https://discord.gg/y4p8KfzrN4