SuperAPI AI 工具集

Unity-MCP

Unity-MCP 是面向 Unity 引擎的 AI 游戏开发助手,包含 AI Skills、MCP 工具与 CLI,支持编辑器与运行时(编译后的游戏内)使用。它可通过 MCP 将 Claude、Cursor、Windsurf、GitHub Copilot 等 AI 智能体连接到 Unity,用于自动化工作流、生成代码、调试与测试。插件内置 70+ 默认 MCP 工具,覆盖资产、包管理、GameObject、场景、截图、控制台、编辑器状态、反射、脚本、测试、Profiler 等类别;任意 C# 方法可通过一行代码变成工具。官方宣称可与 Claude Code、Gemini、Copilot、Cursor 等免费协作。支持本地 stdio 与远程 http 部署,并可在编译后的游戏中使用 LLM 实现动态 NPC 行为或运行时调试。

访问官网

工具介绍

Unity-MCP 是一个 AI 驱动的 Unity 游戏开发助手,面向编辑器(Editor)与运行时(Runtime)两种场景。它通过 MCP(Model Context Protocol)把 Claude、Cursor、Windsurf 等 AI 智能体接入 Unity,用于自动化工作流、生成代码,并让 AI 运行在游戏内部。官方说明其与其他工具不同之处在于:该插件可在已编译的游戏中工作,从而支持实时 AI 调试以及玩家与 AI 的交互。

主要能力

  • AI 智能体:可使用来自 Anthropic、OpenAI、Microsoft 或其他提供方的智能体,官方称无供应商锁定。
  • 工具:提供广泛的默认 MCP 工具,用于操作 Unity 编辑器。
  • Skills:根据操作系统、Unity 版本以及项目中的插件生成 AI 技能。
  • 代码与测试:用 AI 智能体开发游戏机制并对其进行测试。
  • Runtime(游戏内):在已编译的游戏内直接使用 LLM,实现动态 NPC 行为或调试。
  • 调试支持:让 AI 调试并修复项目中的问题。
  • 自然对话:像与人交谈一样与 AI 聊天。
  • 灵活部署:通过配置支持本地(stdio)与远程(http)。
  • 可扩展:可在项目代码中创建自定义工具。

内置工具分类(70+,安装后即可使用,无需额外配置)

  1. 资产(assets):assets-copy、assets-create-folder、assets-delete、assets-find、assets-find-built-in、assets-get-data、assets-material-create、assets-modify、assets-move、assets-prefab-close、assets-prefab-create、assets-prefab-instantiate、assets-prefab-open、assets-prefab-save、assets-refresh、assets-shader-get-data、assets-shader-list-all。
  2. 包管理(package):package-add、package-list、package-remove、package-search。
  3. GameObject 与组件:gameobject-component-add、gameobject-component-destroy、gameobject-component-get、gameobject-component-list-all、gameobject-component-modify、gameobject-create、gameobject-destroy、gameobject-duplicate、gameobject-find、gameobject-modify、gameobject-set-parent。
  4. 对象:object-get-data、object-modify。
  5. 场景(scene):scene-create、scene-get-data、scene-list-opened、scene-open、scene-save、scene-set-active、scene-unload。
  6. 截图(screenshot):screenshot-camera、screenshot-game-view、screenshot-isolated、screenshot-scene-view。
  7. 控制台(console):console-clear-logs、console-get-logs。
  8. 编辑器状态与选择:editor-application-get-state、editor-application-set-state、editor-selection-get、editor-selection-set。
  9. 反射(reflection):reflection-method-call、reflection-method-find(可查找包括私有方法在内的 C# 方法)。
  10. 脚本(script):script-delete、script-execute、script-read、script-update-or-create。
  11. 测试(tests):tests-run(支持 EditMode/PlayMode 过滤与详细结果)。
  12. 类型:type-get-json-schema(通过反射为 C# 类型生成 JSON Schema)。
  13. Profiler:profiler-capture-frame、profiler-clear-data、profiler-enable-module、profiler-get-memory-stats、profiler-get-rendering-stats、profiler-get-script-stats、profiler-get-status、profiler-list-modules、profiler-load-data、profiler-save-data、profiler-start、profiler-stop。

使用方式(官方三步) 步骤一:安装插件。方式一:下载 .unitypackage 安装器,导入 Unity 项目(可双击文件由 Unity 自动打开,或先打开 Unity 编辑器,再通过 Assets/Import Package/Custom Package 选择文件)。方式二(推荐):运行 openupm add com.ivanmurzak.unity.mcp,或使用 CLI:npx unity-mcp-cli install-plugin ./MyUnityProject。官方提示项目路径不能包含空格。 步骤二:选择并安装一个 AI 智能体,例如 Claude Code(推荐)、Claude Desktop、VS Code 中的 GitHub Copilot、Cursor 或其他受支持客户端。官方说明并不需要全部安装,任选一个作为与 LLM 沟通的主聊天窗口即可;关键要求是该 AI 智能体必须支持 Skills 或动态 MCP 工具更新。 步骤三:配置 AI 智能体。打开 Unity 项目,进入 Window/AI Game Developer;方式一:点击 Auto-generate Skills(推荐);方式二:点击 Configure Model Context Protocol (MCP)。若所用 MCP 客户端不在列表中,可使用窗口中显示的原始 JSON 手动注入到该客户端。也可使用命令行:npx unity-mcp-cli setup-skills claude-code ./MyUnityProject。完成后即可向 AI 提出如“Create 3 cubes in a circle with radius 2”之类的请求。

手动配置要点:根据环境选择 <command>;将 <unityProjectPath> 替换为 Unity 项目完整路径;将 <port> 替换为 AI Game Developer 配置中的端口;在命令行添加 MCP 服务器,服务器名称 ai-game-developer,类型 local。

CLI 与云端说明:官方称通过 unity-mcp-cli 安装插件无需 Unity 编辑器。unity-mcp-cli login 会执行浏览器 OAuth 设备流程,并将凭据存储在共享机器存储(~/.ai-game-dev/credentials.json),无需粘贴个人访问令牌。默认情况下,setup-mcp 写入的 AI 智能体配置指向按项目固定的端点 https://ai-game.dev/mcp/p/<pin>;传入 --no-pin 可使用共享端点 https://ai-game.dev/mcp。团队可通过注册码分发访问权限:unity-mcp-cli install-plugin --enroll <code>。

团队更新通知设置:当 OpenUPM 上有新版本时,插件会在编辑器启动时显示更新弹窗,默认每位团队成员需各自点击“Do not show again”。对于多人 Unity 项目,可由负责插件版本管理的工程师打开 Edit ▸ Project Settings ▸ AI Game Developer,启用 “Disable update notifications for the entire team”,该设置保存到 ProjectSettings/AI-Game-Developer-UpdateSettings.asset,每个项目只需设置一次,提交该文件后拉取该提交的成员都会抑制弹窗;同一开关也可通过 Tools ▸ AI Game Developer ▸ Updates ▸ Disable Update Notifications (Team) 访问。

服务器部署:文档包含 Unity MCP Server 设置、插件变量、Docker、streamableHttp 传输、stdio 传输、自定义端口与二进制可执行文件等章节。

架构说明:文档解释了什么是 MCP、AI 智能体、MCP Server、MCP Tool(及其使用时机)、MCP Resource(及其使用时机)、MCP Prompt(及其使用时机)。

扩展与自定义:可添加自定义 Tool 与自定义 MCP Prompt;需要更多工具时可安装扩展或创建自己的工具。

适用场景:Unity 游戏开发中的自动化编辑器操作、代码生成、测试、调试、性能分析,以及在编译后游戏内使用 LLM 实现动态 NPC 行为或玩家-AI 交互。

限制与注意事项:官方要求项目路径不能包含空格;需要 AI 智能体支持 Skills 或动态 MCP 工具更新;官方称与 Claude Code、Gemini、Copilot、Cursor 等免费协作,但未提供具体收费、价格或平台限制信息,暂未提供;其余功能细节与具体版本要求以官方文档为准。