SuperAPI AI 工具集

unity-mcp

编程与开发

查看项目

更新于 10-15 19:54

技能介绍

用途:当 Unity 编辑器自动化作为执行面时使用本技能。目标不只是连接 MCP,而是把编辑器当作安全、可检查的目标,用于脚本化场景修改、包操作、脚本验证、测试和 API 检查。

主要能力:上游工具涵盖场景与对象控制(manage_scene、manage_gameobject、manage_components、manage_prefabs);脚本生命周期(create_script、manage_script、script_apply_edits、validate_script、manage_script_capabilities);UI、渲染与内容(manage_ui、manage_material、manage_texture、manage_shader、manage_vfx、manage_animation、manage_camera、manage_graphics、manage_packages);搜索与验证(find_in_file、find_gameobjects、run_tests、get_test_job、read_console、unity_docs、unity_reflect);控制与批处理(batch_execute、manage_tools、set_active_instance、refresh_unity)。

使用方式:先在 Unity Package Manager 安装 https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main,Beta 可用 #beta 分支,上游也支持 OpenUPM。传输默认用 HTTP:{"mcpServers":{"unityMCP":{"url":"http://localhost:8080/mcp"}}};需要本地进程传输时用 stdio:{"mcpServers":{"unityMCP":{"command":"uvx","args":["--from","mcpforunityserver","mcp-for-unity","--transport","stdio"]}}}。编辑器内快速开始:Window > MCP for Unity,Start Server,配置客户端,看到 Connected。多实例时先读 unity_instances,再 set_active_instance 传入 Name@hash,之后所有工具针对该活动实例。写脚本前用 unity_docs 和 unity_reflect,编辑后跑 validate_script 并读 read_console,必要时 run_tests。重复性资源编辑用 batch_execute。脚本正确性重要时启用 Roslyn 一键安装。

适用场景:配置 AI 客户端连接运行中的 Unity 编辑器;从智能体工作流自动化场景、预制体、脚本或包变更;多项目会话中路由命令;用 Roslyn 感知工具验证生成的 C#;在写脚本前查文档与反射;用 run_tests、get_test_job、read_console 做编辑器侧验证。

限制:资料未提供收费、价格、平台支持范围或效果保证。使用前须确认活动 Unity 实例,否则可能改错项目。stdio 仅在客户端或环境需要时使用。validate_script 与 read_console 应配合使用。