Unity MCP 服务器

Unity MCP服务器

此存储库是Unity包根目录，包含两个组件：

• Editor/：Unity编辑器控制包源代码（HTTP/命名管道工具端点）
• Gateway~/：MCP网关源进程（.NET，可流式传输HTTP）

Unity编辑器控件

使用控制包并打开：

• Tools/Unity MCP Control

控制窗口同时管理以下两项：

• 控制端点生命周期（启动/停止和设置）
• 网关进程生命周期（启动/停止/重启和进程监控）

设置面板当前提供：

• 网关进程设置，例如 Dotnet Executable 和 Gateway Project Path
• Enabled Modules 作为来源于的多选下拉列表 Gateway~/schemas/mcp-tool-modules.json
• Control Transport 有条件地显示特定于运输的字段
• 共享控制设置，如超时、路径分配列表、组件分配列表和自动启动标志

默认情况下，MCP客户端连接到网关 http://127.0.0.1:38100/mcp. 网关调用命名管道上的Unity Control，因此只暴露了一个HTTP端点。

运行时契约

常见环境变量：

• UNITY_MCP_ROOT （默认值应指向 Gateway~/)
• UNITY_MCP_ENABLED_MODULES （逗号分隔的模块名称，如 project_read,scene_read,prefab_read,asset_read)
• UNITY_MCP_GATEWAY_TRANSPORT (streamable-http 违约，或 stdio)
• UNITY_MCP_STREAMABLE_HTTP_URL （默认值 http://127.0.0.1:38100/mcp)
• UNITY_MCP_CONTROL_TRANSPORT (pipe 违约，或 http)
• UNITY_MCP_CONTROL_HTTP_URL （可选HTTP控制端点，默认值 http://127.0.0.1:38110/)
• UNITY_MCP_CONTROL_PIPE_NAME
• UNITY_MCP_CONTROL_TIMEOUT_MS
• UNITY_MCP_ALLOWED_PATH_PREFIXES
• UNITY_MCP_ALLOWED_COMPONENT_TYPES

当前运行时工具名称由中的活动模式定义 Gateway~/schemas/ 并由以下人员路由 Editor/Control/ControlToolDispatcher.cs.

模块分类

运行时分类是目标第一，操作第二：

• project_read, project_execute, project_write
• editor_read, editor_execute, editor_write
• runtime_read, runtime_execute
• scene_read, scene_execute, scene_write
• gameobject_read, gameobject_write
• prefab_read, prefab_write
• asset_read, asset_write

当前的创作边界是：

• scene_*：仅场景容器和场景资源生命周期
• gameobject_*：场景活体检查和变异，包括场景组件操作
• prefab_*：预制模块边界，具有显式 prefab_asset_* 和 prefab_instance_* 其下的工具名称
• asset_*：通用项目资产搜索、检查、导入、创建和文件级修改

人工智能临时场景工作流应该更喜欢添加场景加载和关闭，而不是替换用户当前加载的场景设置。

场景上下文更改工具的使用 dirtyEditorContextPolicy 因此，在没有交互式保存提示的情况下处理脏加载的场景和脏预制阶段会话。

目前的基础包括：

• 项目读取表面加上构建目标切换、玩家构建和测试执行工具
• 编辑器选择和控制台工具
• 运行时播放模式状态和启动/停止工具
• 场景打开/关闭/创建/保存工具
• 场景直播游戏对象和组件读/写工具
• 预制资产检查和预制实例生命周期/覆盖工具
• 资产搜索/引用工具以及导入、复制/移动、重命名、删除到垃圾箱和本机资产创建工具

附加文件

• 控制架构
• 编辑器控制窗口
• 刀具目录
• 运行时工具模式
• 编写工具模式