返回 MCP 目录
public公开dns本地运行

advanced-unity-mcp

Unity MCP是一款通过自然语言命令控制Unity编辑器的AI助手工具,支持创建、修改、管理游戏对象、场景、材质等,简化开发流程。

article

README

🚀 高级Unity MCP - 来自Code Maestro

通过自然语言命令,利用人工智能控制Unity。

无需再逐个点击菜单和手动设置游戏对象,只需告诉您的AI助手您的需求,就能让一切自动实现。

"创建一个红色材质并将其应用到一个立方体上"
"为安卓平台构建项目" 
"创建一个包含相机和定向光的新场景"

观看视频

观看视频

🚀 快速开始

1. 安装插件包

在Unity的包管理器中,选择“从Git URL添加包”,输入以下链接:

https://github.com/codemaestroai/advanced-unity-mcp.git

2. 连接您的AI

  • 在Unity中,导航至Code Maestro > MCP Dashboard
  • 点击您首选的MCP客户端旁边的配置按钮。
  • 开始下达命令吧!

支持的MCP客户端:Code Maestro、GitHub Copilot、Cursor、Windsurf、Claude Code以及其他任何支持MCP的智能编程助手。

✨ 主要特性

  • 核心编辑器控制:播放、暂停、停止游戏,执行菜单命令,读取和清除控制台消息。
  • 资源与场景管理:创建、修改、删除材质、预制体、脚本,管理场景和游戏对象。
  • 构建与平台工具:设置构建选项,切换平台,进行安卓调试桥操作。
  • 项目配置:管理Unity插件包、项目设置、玩家偏好设置和外部工具。
  • 性能分析:控制Unity性能分析器,查找性能瓶颈。

💻 使用示例

  • "检查控制台是否有错误信息"
  • "创建一个名为PlayerMovement的脚本,实现WASD控制"
  • "将构建目标切换到iOS"
  • "为选中的对象添加刚体组件"
  • "创建一个具有金属属性的新材质"
  • "将当前游戏对象保存为预制体"
  • "清除所有控制台消息并检查是否有警告"

📚 详细文档

工作原理

Unity MCP通过模型上下文协议(Model Context Protocol)将您的Unity编辑器与AI助手连接起来。它由两个组件协同工作:

  • 桥接服务器:在Unity编辑器中运行,提供API访问。
  • 中继服务器:处理与MCP客户端的通信。

安装插件包并配置好MCP客户端后,系统会自动完成设置。

系统要求

  • Unity 2022及以上版本。
  • MCP客户端(如GitHub Copilot或Cursor)。

Code Maestro 打造 • 加入我们的Discord社区报告问题

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端