SuperAPI AI 工具集

unity-mcp

智能体与模型

查看项目

更新于 10-16 06:44

技能介绍

用途:作为通过 MCP 操作 Unity 的专家指南,帮助在 Unity 自动化任务中正确、稳定地调用 MCP for Unity 工具。

主要能力与流程:采用“资源优先”工作流——先用 mcpforunity://editor/state 检查编辑器状态(ready_for_tools),再读资源了解场景、GameObject、Prefab 等上下文,然后用 find_gameobjects 或资源查询定位目标,最后调用工具(如 manage_gameobject、create_script)并验证。文档按领域组织工具与资源,覆盖 gameobjects、scripts、scene、materials、prefabs、testing、editor、assets、advanced(纹理、VFX、着色器等)。

必要用法:目标定位优先使用实例 ID,其次精确名称(by_name 为精确匹配),再次标签或组件搜索。脚本操作后需轮询 mcpforunity://editor/state,直到 external_changes_dirty=false、is_compiling=false、last_domain_reload_after_unix_ms 已设置,再 read_console 检查错误,然后添加组件。多对象创建应使用 batch_execute 保证原子性并避免层级损坏,例如 batch_execute(commands=[...]);不要顺序逐个创建。

适用场景:Unity 编辑器内的 GameObject、脚本、场景、材质、预制体、测试、资源与高级特效等自动化操作。

限制与注意:Unity 编译中或活动实例不正确时工具会失败;by_name 不支持部分匹配;大查询应使用 page_size;状态可能过期(超过 60 秒)需重新轮询;出现 busy 响应表示 Unity 正在编译。文档声称覆盖 27 个工具、17 个资源、100% 有文档。具体安装方式与收费信息暂未提供。