unity-mcp

“

通过 AI 助手（如 Claude、Cursor 等）与 Unity 编辑器进行交互，帮助开发者更高效地创建 Unity 应用。

Github地址

https://github.com/CoplayDev/unity-mcp

主要功能

• 自然语言操控：通过 AI 助手使用自然语言指令来执行 Unity 任务。

• 强大工具集：提供一系列工具来管理资源、场景、材质、脚本和编辑器功能。

• 自动化工作流程：自动化重复的 Unity 工作流程，提高开发效率。

• 可扩展性：设计为与各种 MCP 客户端协作，支持多种 AI 助手。

可用工具

AI 助手可以使用以下功能：

• execute_menu_item：执行 Unity 编辑器菜单项。

• manage_asset：执行资源操作（导入、创建、修改、删除等）。

• manage_editor：控制和查询编辑器的状态和设置。

• manage_gameobject：管理游戏对象（创建、修改、删除、查找和组件操作）。

• manage_prefabs：执行预制件操作。

• manage_scene：管理场景（加载、保存、创建、获取层次结构等）。

• manage_script：传统脚本操作的兼容性路由器。

• manage_shader：执行着色器 CRUD 操作。

• read_console：获取或清除控制台消息。

• run_tests：在 Unity 编辑器中运行测试。

• set_active_instance：将后续工具调用路由到特定的 Unity 实例。

• apply_text_edits：精确文本编辑。

• script_apply_edits：结构化 C# 方法/类编辑。

• validate_script：快速验证脚本以捕获语法/结构问题。

可用资源

AI 助手可以检索以下资源：

• unity_instances：列出所有正在运行的 Unity 编辑器实例及其详细信息。

• menu_items：检索 Unity 编辑器中所有可用的菜单项。

• tests：检索 Unity 编辑器中所有可用的测试。

• editor_active_tool：当前活动的编辑器工具。

• editor_prefab_stage：当前预制件编辑上下文。

• editor_selection：当前选定对象的详细信息。

• editor_state：当前编辑器运行时状态。

• editor_windows：所有当前打开的编辑器窗口及其状态。

• project_info：静态项目信息（根路径、Unity 版本等）。

• project_layers：项目中定义的所有层及其索引。

• project_tags：项目中定义的所有标签。

工作原理

MCP for Unity 使用两个组件：

MCP for Unity Bridge：在 Unity 编辑器内运行的包。

MCP for Unity Server：本地运行的 Python 服务器，用于在 Unity Bridge 和 MCP 客户端之间通信。