Unity-MCP

让 AI 直接操控 Unity，一行代码把 C# 方法变成 AI 工具

Unity-MCP 是一个为 Unity 引擎打造的 AI 开发与测试闭环工具集，包含 AI Skills、MCP Tools 和 CLI。它解决了 AI 编程工具难以直接操作 Unity 编辑器、无法高效进行游戏开发自动化的问题。核心能力包括：通过 MCP 协议让 Claude Code、Gemini、Copilot、Cursor 等 AI 助手直接控制 Unity 编辑器（如场景操作、资源管理、运行测试）；提供 CLI 快速初始化项目；通过单行特性（Attribute）将任意 C# 方法暴露为 AI 可调用的工具，极大降低扩展成本；同时优化 token 使用，减少 AI 交互开销。项目完全免费，支持主流 AI 工具，适合游戏开发者构建 AI 驱动的自动化开发流程。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4327

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队IvanMurzak

所属国家

官网地址https://ai-game.dev

GitHubhttps://github.com/IvanMurzak/Unity-MCP

定价模式free

价格说明完全免费的开源项目，无付费版本，可自行部署使用。

访问状态

是否开源是

开源协议Apache-2.0

主要语言C#

技术栈/模型ai,ai-integration,anthropic,claude,claude-code,claude-desktop,cli,copilot,cursor,game-development,gamedev,gemini,llm,mcp,mcp-server,model-context-protocol,openai,unity,windsurf

GitHub 星标★ 4327

30天Star增速

HF 下载量

上线时间2025-04-02 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

已安装 Node.js 与 npm（用于全局安装 unity-mcp-cli）
Unity 编辑器，且 Unity 项目路径不能包含空格（如 C:/MyProjects/MyProject）
一个 AI 客户端（推荐 Claude Code，也支持 Claude Desktop、GitHub Copilot、Cursor、Gemini、Antigra
AI 客户端需支持 Skills 或动态 MCP Tool 更新

安装与启动步骤

1安装 unity-mcp-cli

通过 npm 全局安装官方 CLI，后续用它把插件装进 Unity 项目并配置 AI 客户端。
```
npm install -g unity-mcp-cli
```
2给项目装插件

把 “AI Game Developer” 插件安装到指定 Unity 项目目录，路径换成你的真实项目路径。也可改用下载 .unitypackage 双击导入，或 openupm add com.ivanmurzak.unity.mcp。
```
unity-mcp-cli install-plugin ./MyUnityProject
```
3可选安装 Unity

机器上还没有合适版本的 Unity 时可执行；已有 Unity 编辑器可跳过。
```
unity-mcp-cli install-unity
```
4打开配置窗口

用 Unity 打开项目，在菜单栏进入 Window/AI Game Developer，窗口里会显示 MCP 原始 JSON 与端口等信息。
5生成 Skills/配置 MCP

在窗口里点 Auto-generate Skills（推荐）或 Configure MCP；也可用 CLI 自动写入某个 AI 客户端的 Skills。
```
npx unity-mcp-cli setup-skills claude-code ./MyUnityProject
```
6手动接入客户端

窗口自动配置失败时，用窗口里的命令手动添加 MCP Server：把路径换成你的项目路径，port 换成窗口里显示的端口，Windows/Mac/Linux 二进制路径不同。
```
claude mcp add ai-game-developer "/your/unityProject/Library/mcp-server/win-x64/gamedev-mcp-server.exe port= client-transport=stdio"
```

关键配置

配置项	必填	说明	示例
`port`	是	MCP Server 监听端口，取自 AI Game Developer 窗口配置
`client-transport`	是	客户端传输方式，命令行配置时固定为 stdio	`stdio`

如何确认成功

Unity 的 Window/AI Game Developer 显示已配置成功；对 AI 说 “Create 3 cubes in a circle with radius 2”，场景中能自动生成 3 个立方体。

常见问题

Q：项目路径里有空格怎么办？

A：README 明确要求项目路径不能含空格，例如 C:/My Projects/My Project 不可用。请先把 Unity 项目移动到无空格的路径，如 C:/MyProjects/MyProject，再重试。

Q：不想用 CLI，怎么装插件？

A：两种方式：下载 AI-Game-Dev-Installer.unitypackage 后双击或经 Assets/Import Package/Custom Package 导入；或执行 openupm add com.ivanmurzak.unity.mcp。

Q：自动配置 MCP 失败怎么办？

A：改用窗口 AI Game Developer (Unity-MCP) 中显示的原始 JSON，按你所用的 MCP 客户端文档手动注入配置即可。

Q：可以用哪些 AI 客户端？

A：Claude Code（推荐）、Claude Desktop、GitHub Copilot in VS Code、Antigravity、Cursor、Windsurf 等均可，要求客户端支持 Skills 或动态 MCP Tool 更新。

Q：需要哪些额外工具扩展？

A：按需安装官方扩展，如 AI Animation、AI Cinemachine、AI InputSystem、AI Navigation、AI ParticleSystem、AI ProBuilder、AI Splines、AI Terrain、AI Tilemap、AI Timeline。

注意事项

Unity 项目路径不能包含空格，否则安装/运行会失败
CLI 安装与插件安装是两步，缺一不可；npx unity-mcp-cli 可替代全局命令
手动配置时需按平台选择对应二进制：win-x64/win-x86/win-arm64、osx-arm64/osx-x64、linux-x64/linux-arm64
需要更多工具时可安装官方扩展，或用单行特性把自定义 C# 方法暴露为 AI 工具

核心亮点

单行特性即可将任意 C# 方法转为 AI 工具，扩展成本极低
兼容 Claude、Gemini、Copilot、Cursor 等主流 AI，且完全免费
提供 CLI 快速搭建，并优化 token 使用，降低 AI 调用成本

不足之处

文档/社区待观察
依赖 MCP 生态，部分 AI 工具对 MCP 支持尚不稳定

适用场景

AI 辅助 Unity 游戏开发，如自动生成场景、调整组件
自动化测试流程，AI 驱动运行和验证游戏逻辑
快速原型制作，通过自然语言指令操作 Unity 编辑器

替代项目

Unity AI Assistant、Copilot for Unity、MCP Unity Bridge

项目介绍

Unity-MCP 是智能体领域的开源项目，由 IvanMurzak 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（4,327）位列前 10%，在智能体分类的 2,499 个项目里位列前 11%。

近 42 天，它的 GitHub 星标从 3,875 增加到 4,327，净增 452。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。完全免费的开源项目，无付费版本，可自行部署使用。

它主要面向的使用场景是：AI辅助Unity游戏开发，如自动生成场景、调整组件。同类可对比的替代方案包括 Unity AI Assistant、Copilot for Unity、MCP Unity Bridge。

上一篇：awesome-openclaw-agents

下一篇：MathModelAgent