海外访问:www.kdjingpai.com
Ctrl + D 收藏本站

N8N2MCP 是一个开源工具,旨在帮助用户将 n8n 工作流转换为 Model Context Protocol (MCP) 服务器。它让用户能够通过 n8n 的可视化编辑器创建自动化流程,并快速部署为 MCP 服务器,与 Claude、Cursor 或 Super Chain 等 AI 助手无缝集成。用户只需简单配置,即可让 AI 助手调用这些工作流作为自定义工具。N8N2MCP 提供了一个基于 Web 的工作流管理平台和高效的 MCP 路由系统,适合需要快速部署自动化任务的开发者或团队。项目托管在 GitHub,采用开源模式,鼓励用户贡献代码和反馈。

 

功能列表

  • 将 n8n 工作流转换为 MCP 服务器,支持 AI 助手调用。
  • 提供 Web 界面,方便管理、部署和配置工作流。
  • 支持一键部署,生成本地托管的 MCP 服务器。
  • 内置 MCP 路由器,确保高效的服务器创建和请求处理。
  • 支持与 Claude、Cursor 和 Super Chain 等平台集成。
  • 提供安全管理机制,包括凭证管理、API 密钥轮换和 HTTPS 支持。
  • 支持 Supabase 数据库,用于存储用户配置和工作流数据。
  • 使用 Playwright 进行 n8n 认证和浏览器自动化操作。

使用帮助

安装流程

要使用 N8N2MCP,需要在本地或服务器上完成安装和配置。以下是详细步骤:

  1. 克隆代码库
    在终端运行以下命令,将 N8N2MCP 项目克隆到本地:

    git clone https://github.com/Super-Chain/N8N2MCP.git
    cd N8N2MCP
    
  2. 安装依赖
    使用 Python 包管理器安装项目所需依赖:

    pip install -r requirements.txt
    
  3. 安装 Playwright 浏览器
    N8N2MCP 依赖 Playwright 进行 n8n 的认证和自动化操作。运行以下命令安装浏览器二进制文件:

    playwright install
    

    注意:如果未正确安装 Playwright,系统将使用默认凭证,导致功能受限。

  4. 配置环境变量
    复制示例环境配置文件并进行编辑:

    cp .env.example .env
    

    使用文本编辑器打开 .env 文件,填入以下关键配置:

    • Supabase 配置:
      SUPABASE_URL=https://your-project-id.supabase.co
      SUPABASE_KEY=your_supabase_anon_key
      SUPABASE_SERVICE_KEY=your_supabase_service_role_key
      
    • n8n 配置:
      X_N8N_API_KEY=your_n8n_api_key
      N8N_BASE_URL=https://your-n8n-instance.com
      N8N_USERNAME=your_n8n_username
      N8N_PASSWORD=your_n8n_password
      
    • MCP 路由器配置:
      N8N_BUILDER_URL=http://localhost:6545
      FLASK_HOST=0.0.0.0
      FLASK_PORT=5000
      MCP_HOST=0.0.0.0
      MCP_PORT=6545
      

    请替换为实际的配置值,确保 n8n 实例和 Supabase 服务可访问。

  5. 运行 MCP 路由器
    启动 MCP 路由器以处理请求:

    cd mcp_router
    python mcp_router.py --log-level debug
    

    调试模式(--log-level debug)可查看详细日志,便于排查问题。

  6. 测试组件
    测试工作流解析器和 MCP 路由器是否正常运行:

    python -m agent_marketplace.n8n_workflow_parser
    python -m mcp_router.mcp_router
    

主要功能操作

1. 转换 n8n 工作流为 MCP 服务器

  • 在 n8n 界面中创建或编辑工作流,使用可视化编辑器设计自动化任务。
  • 通过 N8N2MCP 的 Web 界面(默认运行在 http://localhost:5000)上传 n8n 工作流 JSON 文件或模板链接。
  • 点击“部署”按钮,系统会解析工作流并生成 MCP 服务器。生成后,系统返回一个服务器 URL(如 http://localhost:6545)。
  • 将该 URL 粘贴到支持 MCP 的 AI 助手(如 Claude 或 Cursor)中,即可调用工作流功能。

2. 管理 MCP 服务器

  • 访问 Agent Marketplace(Web 界面),查看已部署的 MCP 服务器列表。
  • 可以暂停、删除或重新配置服务器,支持动态调整工作流参数。
  • 使用 Supabase 数据库管理用户配置和数据,确保数据隔离和安全性。

3. 集成 AI 助手

  • 在 Claude、Cursor 或 Super Chain 中,添加 MCP 服务器 URL 作为自定义工具。
  • AI 助手会通过 MCP 协议调用服务器,执行工作流中的任务,如数据处理、API 调用或自动化操作。
  • 示例:如果工作流包含发送邮件的功能,AI 助手可直接触发邮件发送。

4. 安全管理

  • 定期轮换 n8n API 密钥和 Supabase 密钥,确保安全性。
  • 在生产环境中启用 HTTPS,使用 SSL 证书保护数据传输。
  • 配置行级安全(RLS)策略,确保用户数据隔离。

注意事项

  • 确保 n8n 实例正常运行并可通过 N8N_BASE_URL 访问。
  • Playwright 的安装和配置对 n8n 认证至关重要,未正确配置可能导致功能受限。
  • 调试时可启用 Flask 调试模式:
    export FLASK_DEBUG=1
    
  • 检查 .env 文件中的所有配置项,避免因配置错误导致部署失败。

应用场景

  1. 自动化营销任务
    开发者可以将 n8n 工作流设计为自动化发送营销邮件或分析用户数据,转换为 MCP 服务器后,AI 助手可根据客户行为触发个性化邮件发送。
  2. 数据处理与集成
    数据分析师可使用 N8N2MCP 将复杂的数据处理流程(如从 API 抓取数据并存储到数据库)部署为 MCP 服务器,供 AI 助手调用以生成报告。
  3. AI 助手增强
    Claude 或 Cursor 用户可通过 N8N2MCP 扩展 AI 功能,例如将 n8n 工作流集成到 AI 助手中,实现文件管理、数据分析或代码生成。
  4. 快速原型开发
    初创公司可利用 N8N2MCP 快速部署自动化原型,测试业务流程,并通过 AI 助手验证功能可行性。

QA

  1. N8N2MCP 支持哪些 AI 助手?
    目前支持 Claude、Cursor 和 Super Chain 等兼容 MCP 协议的 AI 助手。未来可能扩展到更多平台。
  2. 是否需要 n8n 专业知识才能使用?
    需要基本了解 n8n 的工作流创建,但 N8N2MCP 的 Web 界面简化了部署过程,无需深入编程知识。
  3. 如何确保服务器安全性?
    建议使用 HTTPS、定期轮换 API 密钥、启用 RLS 策略,并避免在服务器端存储用户凭证。
  4. 如果 Playwright 安装失败怎么办?
    检查网络连接,确保运行 playwright install 命令。如果失败,可尝试手动下载浏览器二进制文件,或联系社区支持。
0已收藏
0已赞

相关推荐

找不到AI工具?在这试试!

输入关键词,即可 无障碍访问 必应 搜索,快速找到本站所有 AI 工具。

邮箱

联系我们

回顶部

zh_CN简体中文