AI导哈

Unity着色器图形MCP

专注于Unity着色器图形的元编程控制协议，支持节点创建、连接和图形导出功能。

  • by Hanjo92
  • C#
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Hanjo92/unity-shader-graph-mcp

使用说明

统一着色器图mcp

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

当前稳定版本： 1.4.0

下一个里程碑目标：发布-1.4.0 后续节点升级和路由切片

1.4.0 关闭显式可配置和资产绑定的节点升级切片，同时保持 包支持的编辑循环显式、基于推广和验证驱动：

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

Unity侧包支持的引擎和Unity批处理模式MCP桥现在足够稳定，可以专注于 1.4.0 切。 服务器现在支持实时stdio MCP传输和可选的Unity批处理模式桥，用于真正的外部工具调用。 这 1.4.0 里程碑促进了明确的元数据支持 Dropdown, Keyword，弦体 CustomFunction，以及 .shadersubgraph 资产绑定 SubGraphNode 没有声明通用节点或端口覆盖的路径。

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

支持边界快速读取

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

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

对于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 对于当前任务拆分。

发布说明

相关 MCP