用途:为 n8n 工作流中的节点配置提供操作感知(operation-aware)指导,解决“哪些字段必填、字段为何出现或消失、如何逐步发现配置”的问题。
主要能力:
- 操作感知配置:resource + operation 决定必填字段。例如 Slack 的 post 需要 channel 与 text,update 则需要 messageId 与 text,channel 非必填。
- 属性依赖:字段可见性由 displayOptions 控制,如 HTTP Request 中 method 为 POST/PUT/PATCH 时出现 sendBody,sendBody=true 时 body 必填。
- 渐进式发现:默认用 get_node(detail 为 standard,约 1-2K tokens,覆盖约 95% 场景);查找特定字段用 get_node({mode: "search_properties", propertyQuery: "..."});仅在不足时用 detail: "full"(约 3-8K tokens)。
- 动态属性:standard 中标记 dynamicOptions 的属性需用 n8n_explore_node_resources 解析,需 N8N_MCP_ACCESS_TOKEN 与 n8n 2.34+,六个参数均必填,methodName 区分大小写且与 nodeType+version 绑定。
- 常见节点模式:资源/操作型(Slack、Google Sheets、Airtable)、HTTP 型、数据库型、条件逻辑型(IF、Switch、Merge)。
使用方式:先确定节点类型与操作,用 get_node 标准详情查看必填字段,配置后调用 validate_node 校验,按报错迭代补充字段(通常 2-3 轮),再部署。局部修改字符串可用 n8n_update_partial_workflow 的 patchNodeField,find 未命中或多次命中会报错(除非 replaceAll: true)。
限制与注意:不要预设占位凭据 ID,未知时省略 credentials 块;node id 须为 UUID v4;不要硬编码旧 typeVersion;写操作节点可能返回 0 条数据,可设 alwaysOutputData: true;数据库查询勿用 {{ }} 插值以防注入;Switch 无 fallbackOutput 会静默丢弃未匹配项;Merge 的 numberOfInputs 默认 2 且 useDataOfInput 为 1 起始索引;Webhook 错误分支 responseCode 默认仍为 200;Schedule Trigger 时区为工作流级。更多细节见 DEPENDENCIES.md、OPERATION_PATTERNS.md、NODE_FAMILY_GOTCHAS.md。