n8n-mcp-tools-expert

n8n MCP Tools Expert - n8n 工作流开发助手

技能概述

n8n MCP Tools Expert 是一个专为 n8n 工作流自动化开发设计的 MCP 服务器工具集，提供节点搜索、配置验证、工作流管理和模板部署等核心功能，帮助开发者快速构建和调试 n8n 工作流。

适用场景

n8n 节点快速查找

当你需要为工作流选择合适的节点时，可以通过 search_nodes 工具使用关键词快速搜索，或通过 get_node 查看节点的完整操作列表、配置属性和实际使用示例，无需翻阅冗长的官方文档。

配置验证与错误排查

在创建或修改 n8n 节点配置时，使用 validate_node 工具可以快速检查必填字段、参数类型和配置格式，获得详细的错误提示和修复建议，避免运行时配置错误。

工作流模板快速部署

从 2700+ 真实的 n8n 工作流模板库中搜索适合的模板，通过 n8n_deploy_template 工具一键部署到你的 n8n 实例，大幅减少从零开始构建工作流的时间。

核心功能

节点发现与查询

提供多级节点信息查询：search_nodes 支持关键词快速搜索，get_node 支持 minimal/standard/full 三种详细度模式，以及 docs/search_properties/versions 等多种操作模式，帮助精准定位所需节点信息。

智能配置验证

validate_node 和 validate_workflow 提供 minimal/runtime/ai-friendly/strict 四种验证配置文件，可检查节点配置的必填字段、数据类型和结构完整性，并支持自动修复常见配置错误。

工作流全生命周期管理

支持 n8n_create_workflow 创建、n8n_update_partial_workflow 迭代编辑（17 种操作类型）、n8n_validate_workflow 验证和 activateWorkflow 激活，覆盖工作流从开发到上线的完整流程。

常见问题

n8n MCP 工具需要连接 n8n API 吗？

部分工具需要。search_nodes、get_node、validate_node、search_templates 等工具可离线使用，但 n8n_create_workflow、n8n_update_partial_workflow、n8n_deploy_template 等操作类工具需要配置 N8N_API_URL 和 N8N_API_KEY 环境变量。

nodeType 格式有什么区别？

n8n-mcp 工具使用两种 nodeType 格式：搜索和验证工具使用短前缀格式（如 nodes-base.slack），工作流创建和编辑工具使用完整前缀格式（如 n8n-nodes-base.slack）。使用 search_nodes 时会同时返回两种格式，方便转换。

如何避免常见配置错误？

建议使用标准的开发流程：先通过 search_nodes 搜索节点，再用 get_node 了解节点配置，然后用 validate_node 验证配置（推荐 runtime 配置文件），最后通过 n8n_update_partial_workflow 迭代式编辑工作流，每步都验证后再继续下一步。