Repolode
CoplayDev

CoplayDev/unity-mcp

让 Claude、Cursor、VS Code 等 AI 助手通过 MCP 协议直接操作 Unity 编辑器。

Star
15,189
Fork
1,704
未关闭 Issue
106
最近提交
16小时前

这是什么?

MCP for Unity 通过 Model Context Protocol 把 AI 助手与 Unity 编辑器连接起来。以 Unity 包的形式安装并在 MCP 客户端中配置后,助手就能用自然语言创建场景和 GameObject、编辑 C# 脚本、管理资源、运行测试、做性能分析和构建项目。

项目提供一组 MCP 工具入口,覆盖场景、资源、脚本和编辑器操作。它兼容任何支持 MCP 的客户端,包括 Claude Desktop 和 Claude Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等。支持 Unity 2021.3 LTS 至 6.x,需要 Python 3.10 及以上版本(通过 uv 运行)。可通过 git 地址或 OpenUPM 安装,配置窗口可一键为已检测到的客户端完成设置。

项目采用 MIT 许可证,由 CoplayDev 维护,并提供多实例路由、工具分组和可选的 Roslyn 脚本校验等进阶功能。

核心功能

  • 01通过自然语言提示创建和修改场景与 GameObject。
  • 02在 Unity 编辑器内读取、编写和重构 C# 脚本。
  • 03由 AI 助手管理项目资源并运行 Unity 测试。
  • 04兼容任意 MCP 客户端,包括 Claude、Cursor、VS Code 等。
  • 05支持 Unity 2021.3 LTS 至 6.x 版本。
  • 06支持同时连接并路由到多个 Unity 实例。

适用场景

  • 用自然语言描述对象和组件,快速搭建场景原型。
  • 在大型项目中自动化重复的资源或场景编辑工作。
  • 让 AI 助手编写玩法脚本,并在编辑器中验证效果。
  • 在 AI 驱动的工作流中运行 Unity 测试和性能分析。

快速上手

  1. 1

    通过 Unity Package Manager 从 Git URL 安装包

    https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
  2. 2

    在 Unity 编辑器菜单中配置 MCP 客户端

    Window → MCP for Unity → Configure All Detected Clients
  3. 3

    向 AI 助手发出指令,在场景中创建对象

使用前须知

  • 需要 Unity 2021.3 LTS 或更高版本,以及 Python 3.10+ 和 uv。
  • AI 助手对 Unity 编辑器的修改需要仔细检查。

标签

常见问题

unity-mcp 是什么?
让 Claude、Cursor、VS Code 等 AI 助手通过 MCP 协议直接操作 Unity 编辑器。 MCP for Unity 通过 Model Context Protocol 把 AI 助手与 Unity 编辑器连接起来。以 Unity 包的形式安装并在 MCP 客户端中配置后,助手就能用自然语言创建场景和 GameObject、编辑 C# 脚本、管理资源、运行测试、做性能分析和构建项目。
unity-mcp 可以免费使用吗?用的什么许可证?
unity-mcp 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
unity-mcp 还在维护吗?
活跃维护中。unity-mcp 最近一次提交是在 2026年10月19日。
unity-mcp 适合用来做什么?
用自然语言描述对象和组件,快速搭建场景原型。 在大型项目中自动化重复的资源或场景编辑工作。 让 AI 助手编写玩法脚本,并在编辑器中验证效果。 在 AI 驱动的工作流中运行 Unity 测试和性能分析。
unity-mcp 怎么安装和运行?
通过 Unity Package Manager 从 Git URL 安装包: https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main 在 Unity 编辑器菜单中配置 MCP 客户端: Window → MCP for Unity → Configure All Detected Clients 向 AI 助手发出指令,在场景中创建对象
在哪里获取 unity-mcp?
源代码和安装说明在 GitHub 上:https://github.com/CoplayDev/unity-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目