Unity Shader Graph MCP

统一着色器图mcp

以着色器图为中心的MCP for Unity。

当前稳定版本： 1.3.0

下一个里程碑目标： 1.4.0 全节点完成计划

1.3.0 关闭完整节点支撑基础切片，同时保持 包支持的编辑循环显式、基于推广和验证驱动：

• create_graph 对于空白图形
• read_graph_summary
• add_property 对于当前已验证的标量、向量、纹理、梯度、采样器和布尔属性类型
• 财产约束 PropertyNode 工作流和图形合约回放元数据
• add_node 对于当前已验证的图形可添加目录子集
• connect_ports 对于当前验证的标量、向量生成器、逻辑、纹理、法线、颜色布线和属性节点路径
• 布尔边界 PropertyNode.Out -> BranchNode.Predicate
• SampleGradient 图形可添加推广
• 支持发现和快乐路径烟雾动作的设置面板
• 跨支持、筛选、探测失败、初始化器支持、需要元数据、外部资产绑定、特定于包、版本敏感和渲染管道敏感桶的节点目录分类
• 为数学/值/向量、纹理/样本、坐标/实用程序、法线/照明/渲染和便携式默认专用节点推广了可添加图形的节点族
• 升级节点系列的合同重播覆盖率
• 图和子图导出/导入契约路径奇偶性
• save_graph

Unity侧包支持的引擎和Unity批处理模式MCP桥现在足够稳定，可以专注于 1.3.0 切。 服务器现在支持实时stdio MCP传输和可选的Unity批处理模式桥，用于真正的外部工具调用。 这 1.3.0 里程碑现已结束；剩余的通用节点完成工作应跟踪为 1.4.0 随访范围。

此存储库有意拆分为独立的工作区域，因此多个子代理可以并行工作，合并风险最小。

支持边界快速读取

完全着色器图类型发现与完全运行时支持不同。

• supportedNodeTypes 是电流吗 add_node 对抗主义者。将这些名称用于图形可添加节点。
• discoveredNodeTypes 是来自加载的着色器图程序集的更广泛的诊断数据。它可以包括内部、遗留、仅输出、所需元数据、资产绑定或探测拒绝类型。
• nodeCatalogClassification 解释了为什么支持、过滤或延迟发现的节点。
• supportedConnectionRules 是否强制执行 connect_ports matrix。可添加的节点并不意味着可以连接任意端口或类型强制。

对于Unity侧发现，请打开 Tools > Shader Graph MCP > Open Panel，然后使用 List Supported Nodes, Write Node Catalog Report，以及 Write Compatibility Report. 对于外部MCP客户端，请致电 list_supported_nodes 和 list_supported_connections 发行前 add_node 或 connect_ports.

工作区布局

• packages/unity-shader-graph-mcp/：Unity包和编辑器桥
• server/：Python MCP服务器
• contracts/：共享JSON示例和协议说明
• docs/：架构、ADR和并行工作说明

平行工作规则

每个子代理都拥有一个写作用域。除非所有者明确移交，否则不要编辑指定范围之外的文件。

看 docs/parallel-work-split.md 对于当前任务拆分。

发布说明

• 变更日志： 更改日志.md
• 发布清单： release-checklist.md
• GitHub发布草案：
• 最终1.0检查表： 1.0.0-检查表.md
• 最终1.0工作划分： 1.0.0-工作分割.md
• 已完成的1.1计划： 1.1.0-平面.md
• 兼容性矩阵： 相容性矩阵.md
• 当前实施边界： 里程碑边界.md