用途:为 n8n 工作流中的节点配置提供操作感知的指导,帮助判断必填字段、理解属性依赖与字段可见性规则,并支持渐进式发现节点结构。
主要能力:区分不同 resource + operation 下的必填字段差异(如 Slack post 需 channel+text,update 需 messageId+text);解释 displayOptions 控制的字段显示隐藏机制;提供 get_node 的三级细节模式——默认 standard(约 1-2K tokens,覆盖多数场景)、search_properties 按名查找字段、full 完整 schema(约 3-8K tokens);覆盖资源/操作节点、HTTP 节点、数据库节点、条件逻辑节点等常见模式;说明验证驱动配置流程与常见反模式。
使用方式:先用 get_node(standard 为默认)获取必填字段与常见选项;配置后运行 validate_node 校验并迭代;字段不清楚时用 get_node({mode: "search_properties", propertyQuery: "..."});仅在必要时升级到 detail: "full"。动态属性需用 n8n_explore_node_resources 解析,需 N8N_MCP_ACCESS_TOKEN 与 n8n 2.34+。节点 id 须为 UUID v4,typeVersion 应经 get_node 核实。编辑节点内特定字符串可用 patchNodeField。
限制与注意:不要预先堆砌可选字段,不要跳过验证,切换 operation 后须重新检查字段。部分错误配置能通过校验并静默产生错误结果,例如 Switch 缺少 fallbackOutput 会丢弃未匹配项、Merge 的 numberOfInputs 默认 2、数据库查询中 {{ }} 插值存在 SQL 注入风险、Slack Block Kit 需按特定包装、Webhook 响应码默认 200、Schedule Trigger 时区为工作流级别。详细内容见 DEPENDENCIES.md、OPERATION_PATTERNS.md、NODE_FAMILY_GOTCHAS.md。其他环境要求与版本细节资料未完整提供。