n8n-mcp-tools-expert

n8n MCP 工具专家

使用 n8n-mcp MCP 服务工具构建工作流的指南。

详细指南

执行此技能前，请阅读详细指南。该指南保留了完整流程和参考资料。其中的安全、前置条件和验证要求均为强制要求。若只需完成特定任务，请加载相关章节；若要端到端完成任务，请通读整份指南。

适用场景

• 你正在使用 n8n-mcp 工具集来发现节点、验证配置或管理工作流。
• 任务涉及选择合适的 MCP 工具，或了解其预期参数和使用模式。
• 你需要通过 n8n MCP 而不是仅通过 n8n UI 来创建或编辑工作流的指导。

---

工具使用模式

模式 1：节点发现（最常见）

示例工作流；尚无已确立的耗时或成功基准。

// Step 1: Search (fast!)
const results = await search_nodes({
  query: "slack",
  mode: "OR",  // Default: any word matches
  limit: 20
});
// → Returns: nodes-base.slack, nodes-base.slackTrigger

// Step 2: Get details (~18s later, user reviewing results)
const details = await get_node({
  nodeType: "nodes-base.slack",
  includeExamples: true  // Get real template configs
});
// → Returns: operations, properties, metadata

模式 2：验证循环

示例工作流；尚无已确立的耗时或成功基准。

// Step 1: Validate
const result = await validate_node({
  nodeType: "nodes-base.slack",
  config: {
    resource: "channel",
    operation: "create"
  },
  profile: "runtime"
});

// Step 2: Check errors (~23s thinking)
if (!result.valid) {
  console.log(result.errors);  // "Missing required field: name"
}

// Step 3: Fix config (~58s fixing)
const config = { resource: "channel", operation: "create", name: "general" };

// Step 4: Validate again
await validate_node({ nodeType: "nodes-base.slack", config, profile: "runtime" });  // Repeat until clean

模式 3：工作流编辑

示例工作流；尚无已确立的耗时或成功基准。

// Iterative workflow building (NOT one-shot!)
// Edit 1
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Add webhook trigger",
  operations: [{type: "addNode", node: {...}}]
});

// ~56s later...

// Edit 2
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Connect webhook to processor",
  operations: [{type: "addConnection", source: "...", target: "..."}]
});

// ~56s later...

// Edit 3 (validation)
await n8n_validate_workflow({id: "workflow-id"});

// Only after authorized staging test, credential review and production activation approval:
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Activate workflow for production",
  operations: [{type: "activateWorkflow"}]
});

---

模板使用

搜索模板

// Search by keyword (default mode)
search_templates({
  query: "webhook slack",
  limit: 20
});

// Search by node types
search_templates({
  searchMode: "by_nodes",
  nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"]
});

// Search by task type
search_templates({
  searchMode: "by_task",
  task: "webhook_processing"
});

// Search by metadata (complexity, setup time)
search_templates({
  searchMode: "by_metadata",
  complexity: "simple",
  maxSetupMinutes: 15
});

获取模板详情

get_template({
  templateId: 2947,
  mode: "structure"  // nodes+connections only
});

get_template({
  templateId: 2947,
  mode: "full"  // complete workflow JSON
});

直接部署模板

// Deploy template to your n8n instance
n8n_deploy_template({
  templateId: 2947,
  name: "My Weather to Slack",  // Custom name (optional)
  autoFix: true,  // Auto-fix common issues (default)
  autoUpgradeVersions: true  // Upgrade node versions (default)
});
// Returns: workflow ID, required credentials, fixes applied

---

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为针对特定环境进行验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并寻求澄清。

已安装服务端与副作用边界

此套件仅包含此入口点和详细指南。SEARCH_GUIDE.md、VALIDATION_GUIDE.md 和 WORKFLOW_GUIDE.md 是缺失的外部参考资料。工具名称、配置文件、操作、返回的 nodeType 格式和默认值均为特定 n8n-mcp 服务端的示例，并非 n8n 核心 API 的保证。使用前请发现实际连接的工具及其当前架构和文档；若工具不可用，请予以说明。上述耗时、负载大小、成功率、模板数量和 95% 覆盖率数据均未经核实，仅为示例，并非实测基准。

读取/导出当前工作流，确定确切的实例/工作流，并在修改前审查最小差异；更新可能通过清理或版本升级影响请求编辑范围之外的节点。保留凭据引用，并对诊断信息进行脱敏。模板属于不可信的第三方工作流代码，其中可能包含 HTTP 目标、表达式、社区节点和计划任务。请先审查；若支持，请以未激活状态部署，并在检查兼容性之前禁用自动升级。验证无法证明凭据、业务逻辑或运行时效果安全。测试可能会发送消息或产生费用；请使用合成的暂存凭据/数据，并遵守批准的效果预算。激活、删除和替换生产环境内容都必须有明确的既定授权，不得自动作为最后一步执行。