Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client