Unity-MCP

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 406 🐛 待处理 57 👀 关注 30

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4612

维护状态活跃

是否开源开源

定价模式 🏷️完全免费完全免费的开源项目，无付费版本，可自行部署使用。

项目预览

项目数据

分类开源模型

开发团队IvanMurzak

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

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议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 星标★ 4612

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

代码更新2026-11-09

仓库体积296.0 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

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 驱动的自动化开发流程。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4612

技术标签

ai anthropic claude claude-code claude-desktop

使用教程

难度：入门约 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=<port> client-transport=stdio"
```

关键配置

配置项	必填	说明	示例
`port`	是	MCP Server 监听端口，取自 AI Game Developer 窗口配置	`<port>`
`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 工具