CoderGamester/mcp-unity

这是什么？

核心功能

• 01让 AI 助手操作 GameObject、组件、Transform 和材质。
• 02通过 Test Runner 运行 EditMode 与 PlayMode 测试，并执行菜单命令。
• 03以 MCP 资源形式读取控制台日志、场景层级、资产和已安装包。
• 04控制场景的加载、保存、卸载以及播放模式。
• 05支持在一次请求中批量执行多个操作。
• 06为 Cursor、Claude Code、Codex CLI、Copilot、OpenCode 生成客户端配置。

适用场景

• 在 AI 编程助手中用自然语言搭建场景对象、Prefab 和材质。
• 在对话中运行 Unity 测试，并直接读取控制台报错。
• 无需在编辑器中手动点击，批量创建或重命名大量 GameObject。
• 借助场景层级和资产查询，帮助新成员熟悉陌生的 Unity 项目。

快速上手

1. 1

   从 Node.js 下载页面安装 Node.js 18 或更高版本

2. 2

   通过 Unity Package Manager（Window > Package Manager）安装 Unity MCP Server 包

3. 3

   验证 Node.js 已安装

   node --version

使用前须知

• !需要 Unity 6 或更高版本以及 Node.js 18 或更高版本。
• !项目路径包含空格时可能出现连接问题。

标签

常见问题

mcp-unity 是什么？

一个 MCP 插件，让 Cursor、Claude Code、Codex 等 AI 助手直接操作和查询 Unity 编辑器。 MCP Unity 是连接 Unity 编辑器与 Model Context Protocol（MCP）服务的桥接插件。编辑器内运行一个 WebSocket 服务，Node.js 端负责接收 Cursor、Windsurf、Claude Code、Codex CLI、GitHub Copilot、OpenCode 等 AI 客户端的请求，并转发到 Unity 中执行。

mcp-unity 可以免费使用吗？用的什么许可证？

mcp-unity 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

mcp-unity 还在维护吗？

活跃维护中。mcp-unity 最近一次提交是在 2026年10月11日。

mcp-unity 适合用来做什么？

在 AI 编程助手中用自然语言搭建场景对象、Prefab 和材质。 在对话中运行 Unity 测试，并直接读取控制台报错。 无需在编辑器中手动点击，批量创建或重命名大量 GameObject。 借助场景层级和资产查询，帮助新成员熟悉陌生的 Unity 项目。

mcp-unity 怎么安装和运行？

从 Node.js 下载页面安装 Node.js 18 或更高版本 通过 Unity Package Manager（Window > Package Manager）安装 Unity MCP Server 包 验证 Node.js 已安装: node --version

在哪里获取 mcp-unity？

源代码和安装说明在 GitHub 上：https://github.com/CoderGamester/mcp-unity