Repolode
IvanMurzak

IvanMurzak/Unity-MCP

让 Claude、Cursor、Copilot 等 AI 代理通过 MCP 操作 Unity 编辑器,并可在游戏运行时调用 LLM 的插件。

Star
4,497
Fork
399
未关闭 Issue
59
最近提交
7小时前

这是什么?

Unity-MCP 是一个 Unity 插件加 MCP 服务器,可让 Claude Code、Claude Desktop、Cursor、GitHub Copilot、Gemini 等 AI 代理直接操作 Unity 编辑器。安装后,代理可以查看场景层级、创建和修改 GameObject 及组件、管理资源、预制体和场景,读取控制台日志,控制播放模式,截图并运行 Unity 测试。

除编辑器自动化外,项目还提供运行时包,允许已编译的游戏把自身方法暴露为 MCP 工具,使 LLM 能参与游戏逻辑,例如 NPC 决策或棋类机器人。开发者只需为 C# 方法添加特性即可注册自定义工具。插件还会根据项目的 Unity 版本和已安装包生成 AI 技能文件。

安装方式包括 unitypackage 安装包、OpenUPM 以及命令行工具 unity-mcp-cli。服务器既可通过 stdio 在本地运行,也可通过 streamable HTTP 远程运行,并支持 Docker 部署。

核心功能

  • 01允许 AI 代理在 Unity 编辑器中读取和修改场景、GameObject、组件与资源。
  • 02内置 70 多个 MCP 工具,涵盖资源、场景、脚本、控制台和性能分析。
  • 03通过 Roslyn 在运行时编译并执行 C# 代码。
  • 04借助运行时包,在已编译的游戏中接入 LLM 驱动的逻辑。
  • 05支持通过为 C# 方法添加特性来定义自定义工具。
  • 06可通过本地 stdio 或远程 streamable HTTP 运行,并提供 Docker 镜像。

适用场景

  • 通过自然语言让 AI 代理搭建场景布局、预制体和材质。
  • 在调试项目时,让 AI 代理运行 Unity 测试并查看控制台报错。
  • 在已发布的 Unity 游戏中接入由 LLM 控制的 NPC 或游戏机器人。
  • 借助命令行工具和 Docker 部署的服务器,自动化团队项目中的编辑器任务。

标签

常见问题

Unity-MCP 是什么?
让 Claude、Cursor、Copilot 等 AI 代理通过 MCP 操作 Unity 编辑器,并可在游戏运行时调用 LLM 的插件。 Unity-MCP 是一个 Unity 插件加 MCP 服务器,可让 Claude Code、Claude Desktop、Cursor、GitHub Copilot、Gemini 等 AI 代理直接操作 Unity 编辑器。安装后,代理可以查看场景层级、创建和修改 GameObject 及组件、管理资源、预制体和场景,读取控制台日志,控制播放模式,截图并运行 Unity 测试。
Unity-MCP 可以免费使用吗?用的什么许可证?
Unity-MCP 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
Unity-MCP 还在维护吗?
活跃维护中。Unity-MCP 最近一次提交是在 2026年10月19日。
Unity-MCP 适合用来做什么?
通过自然语言让 AI 代理搭建场景布局、预制体和材质。 在调试项目时,让 AI 代理运行 Unity 测试并查看控制台报错。 在已发布的 Unity 游戏中接入由 LLM 控制的 NPC 或游戏机器人。 借助命令行工具和 Docker 部署的服务器,自动化团队项目中的编辑器任务。
在哪里获取 Unity-MCP?
源代码和安装说明在 GitHub 上:https://github.com/IvanMurzak/Unity-MCP

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

相关项目