n8n-mcp

技能简介

n8n-mcp 是 n8n 工作流自动化平台的官方 MCP 服务器，为 AI 助手提供对 n8n 节点文档、属性和操作的全面访问能力。它将 n8n 的 2616 个节点（832 个核心节点 + 1784 个社区节点）以及 2352 个工作流模板的知识传递给 AI 模型，让 AI 能够设计、构建和验证 n8n 工作流。

n8n-mcp 支持云端托管（dashboard.n8n-mcp.com）和自托管两种方式，提供完整的节点搜索、模板查找、工作流验证等功能，是 n8n 生态中最完整的 AI 集成方案。

核心能力

• 2616 个节点知识：覆盖 832 个核心节点和 1784 个社区节点（1495 个已验证）
• 99% 属性覆盖率：详细的节点属性 Schema
• 156 个真实配置示例：从热门模板中提取的实际配置
• 2352 个工作流模板：99.96% 的 AI 元数据覆盖率
• 多 IDE 支持：Claude Code、VS Code、Cursor、Windsurf、Codex、Antigravity
• n8n 实例集成：可直接连接你的 n8n 实例进行工作流部署
• Cloudflare Access 支持：可认证访问受保护的自托管 n8n

安装配置

云端快速开始（推荐）

1. 访问 https://dashboard.n8n-mcp.com 注册
2. 获取 API Key
3. 在 MCP 客户端中添加配置：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "n8n-mcp", "server"],
      "env": {
        "N8N_MCP_API_KEY": "你的API密钥"
      }
    }
  }
}

Claude Code 方式

详细配置请参考官方文档：https://github.com/czlonkowski/n8n-mcp/blob/main/docs/CLAUDE_CODE_SETUP.md

前置要求

• Node.js 18+
• （可选）n8n 实例 URL 和 API Key

使用步骤

1. 获取 API Key：在 dashboard.n8n-mcp.com 注册获取免费配额（每天 100 次调用）
2. 配置 MCP：在 IDE/工具中添加 n8n-mcp 服务器
3. 模板优先：先搜索工作流模板（search_templates），避免从零构建
4. 节点查询：用自然语言搜索所需节点（search_nodes）
5. 配置验证：使用 validate_node 验证节点配置
6. 工作流验证：构建完成后用 validate_workflow 验证整体工作流
7. 部署：如有 n8n API 配置，可直接部署到你的 n8n 实例

适用场景

• AI 辅助工作流设计：用自然语言描述业务流程，AI 生成 n8n 工作流
• 节点配置查询：快速查找特定节点的正确配置方式
• 模板复用：从 2352 个模板中找到相似的已验证工作流
• 自动化调试：AI 帮助分析和修复工作流错误
• 跨平台集成：探索 n8n 与各种服务的连接方式
• 社区节点发现：搜索和了解社区贡献的节点

适用人群

• 使用 n8n 构建自动化工作流的开发者
• 需要 AI 辅助设计复杂业务流程的团队
• 希望快速找到合适 n8n 节点配置的工程师
• 将 n8n 作为主要自动化工具的运维人员

工作原理

n8n-mcp 通过 MCP 协议暴露一系列工具给 AI 调用。核心工具包括：

• search_templates：在 2352 个模板中搜索相似工作流
• search_nodes：搜索 2616 个 n8n 节点的文档和属性
• get_node：获取特定节点的详细配置信息
• validate_node：验证节点配置是否正确
• validate_workflow：验证整个工作流的完整性和正确性
• n8n_create_workflow：直接部署到你的 n8n 实例

AI 通过这些工具获得 n8n 节点的知识，然后生成符合最佳实践的工作流配置。

官方链接

• NPM 页面：https://www.npmjs.com/package/n8n-mcp
• GitHub 仓库：https://github.com/czlonkowski/n8n-mcp
• 云端控制台：https://dashboard.n8n-mcp.com
• 官方文档：https://github.com/czlonkowski/n8n-mcp#readme
• Claude Skills：https://github.com/czlonkowski/n8n-skills