n8n-MCP：AI 驱动的工作流自动化文档服务器

Posted on

n8n-MCP：AI 驱动的工作流自动化文档服务器

为 AI 助手提供全面的 n8n 节点文档、属性和操作信息访问

项目信息

  • GitHub 仓库：https://github.com/czlonkowski/n8n-mcp
  • Stars：8,200+ ⭐
  • 编程语言：TypeScript
  • 分类：Productivity, Workflow Automation
  • 推荐度：4.5/5.0
  • 维护状态：积极维护中
  • 协议：MIT

简介

n8n-MCP 是一个 Model Context Protocol (MCP) 服务器，为 AI 助手（如 Claude Desktop、Claude Code、Windsurf、Cursor）提供对 n8n 工作流自动化平台的全面访问。该服务器涵盖 536 个 n8n 节点，包含 99% 的节点属性覆盖率和 90% 的文档覆盖率，使 AI 助手能够智能地帮助用户构建和管理 n8n 工作流。

功能特性

核心能力

  • 536 个 n8n 节点支持：覆盖 n8n-nodes-base 和 @n8n/n8n-nodes-langchain
  • 99% 节点属性覆盖率：提供几乎完整的节点配置信息
  • 63.6% 节点操作覆盖率：详细的操作说明和参数
  • 90% 文档覆盖率：全面的使用文档和示例
  • 263 个 AI 能力节点：专为 AI 集成设计的节点
  • 2,646 个预提取工作流配置：现成的配置模板
  • 2,500+ 工作流模板：丰富的实际应用案例

智能功能

  • 智能节点搜索：基于语义的节点查找
  • 核心属性提取：自动识别关键配置项
  • 配置验证：实时验证配置正确性
  • AI 工作流验证：智能检查工作流逻辑

支持的工具/资源

MCP Tools

  1. search_nodes：搜索 n8n 节点

    • 基于关键词或功能描述查找节点
    • 支持模糊匹配和语义搜索

  2. get_node_details：获取节点详细信息

    • 完整的节点文档
    • 属性配置说明
    • 操作参数详情

  3. get_workflow_templates：获取工作流模板

    • 按分类浏览模板
    • 搜索特定用例的模板

  4. validate_configuration：验证节点配置

    • 检查配置完整性
    • 提供修正建议

  5. get_node_properties：获取节点属性

    • 详细的属性列表
    • 类型和约束信息

安装配置

方法 1：使用 npx（推荐）

最快速的安装方式，无需本地安装：

1
npx n8n-mcp

方法 2：使用 Docker

1
docker run -p 3000:3000 czlonkowski/n8n-mcp

方法 3：本地安装

1
2
npm install -g n8n-mcp
n8n-mcp

方法 4：Railway 云部署

一键部署到 Railway 云平台，无需本地环境。

Claude Desktop 配置示例

在 ~/.config/Claude/claude_desktop_config.json 中添加：

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}

配置选项说明

  • MCP_MODE: 通信模式，使用 “stdio” 用于标准输入输出
  • LOG_LEVEL: 日志级别（debug/info/warn/error）
  • DISABLE_CONSOLE_OUTPUT: 禁用控制台输出，保持界面清洁

使用示例

示例 1：搜索节点

1
2
3
用户: 我需要一个可以发送电子邮件的节点
AI: 让我搜索相关的节点... [调用 search_nodes]
找到了 Gmail 节点和 Email 节点，Gmail 节点提供更丰富的功能...

示例 2：构建工作流

1
2
3
4
5
用户: 帮我创建一个工作流，当收到 Webhook 请求时发送 Slack 消息
AI: 我会帮你构建这个工作流:
1. Webhook 触发节点 - 接收 HTTP 请求
2. Slack 节点 - 发送消息到指定频道
让我获取这些节点的详细配置... [调用 get_node_details]

示例 3：验证配置

1
2
3
用户: 这个 HTTP Request 节点的配置对吗？
AI: 让我验证一下... [调用 validate_configuration]
发现一个问题：缺少必需的 URL 参数。建议添加...

示例 4：查找模板

1
2
3
用户: 有没有数据同步的工作流模板？
AI: 让我查找相关模板... [调用 get_workflow_templates]
找到 5 个数据同步模板，最受欢迎的是...

适用场景

1. 工作流开发

  • 快速原型：通过自然语言描述快速构建工作流原型
  • 节点选择：智能推荐最适合的节点
  • 配置辅助：AI 协助填写复杂的节点配置

2. 学习和探索

  • 节点发现：探索 n8n 的 536 个节点功能
  • 最佳实践：学习工作流模板中的最佳实践
  • 文档查询：快速查找节点使用文档

3. 故障排查

  • 配置验证：检查工作流配置错误
  • 调试支持：获取节点行为的详细说明
  • 问题诊断：AI 辅助分析工作流问题

4. 自动化咨询

  • 方案设计：为业务需求设计自动化方案
  • 技术选型：选择合适的节点和集成方式
  • 优化建议：改进现有工作流效率

技术亮点

1. 高覆盖率

  • 99% 的节点属性覆盖确保配置准确性
  • 90% 的文档覆盖提供全面的使用指导
  • 2,646 个预提取配置加速开发流程

2. 智能搜索

  • 语义化搜索理解用户意图
  • 多维度匹配（名称、功能、分类）
  • 相关性排序返回最佳结果

3. 实时验证

  • 配置参数类型检查
  • 必需字段完整性验证
  • 逻辑一致性分析

4. 模板库

  • 2,500+ 实际工作流模板
  • 涵盖常见业务场景
  • 可直接导入使用或参考学习

隐私和安全

  • 本地运行：所有数据处理在本地进行
  • 无数据收集：不收集或上传用户数据
  • 开源透明：代码完全开源，可审计
  • MIT 协议：自由使用和修改

与其他 IDE 集成

除了 Claude Desktop，n8n-MCP 还支持：

  • Cursor：AI 代码编辑器
  • Windsurf：协作开发平台
  • Claude Code：命令行 AI 助手
  • VS Code：通过 MCP 扩展

性能优化

  • 轻量级设计：快速启动和响应
  • 缓存机制：预提取的配置减少查询时间
  • 增量加载：按需加载节点详情
  • 资源友好：低内存和 CPU 占用

相关资源

总结

n8n-MCP 是工作流自动化领域的重要 MCP 服务器，它将 n8n 强大的自动化能力与 AI 助手的智能结合，大大降低了工作流开发的门槛。无论是初学者探索 n8n 功能，还是专业开发者快速构建复杂工作流，n8n-MCP 都能提供有力的支持。8,200+ stars 的社区认可度证明了其价值。强烈推荐所有 n8n 用户和工作流开发者试用！

© 2025 Generative AI Discovery All Rights Reserved.
Theme by hiero