综合介绍

N8N2MCP是一个能将N8N工作流转换为模型上下文协议（MCP）服务器的工具平台。它的核心作用是作为一个桥梁，让用户在N8N这个强大的可视化自动化平台中创建的工作流，可以被诸如Claude、Cursor等AI助手作为可调用的外部工具来使用。简单来说，用户可以通过N8N拖拽节点，设计出各种自动化任务，例如数据处理、API连接、发送通知等。然后，通过N8N2MCP，这些自动化任务可以一键部署成一个标准的MCP服务。AI大模型在需要时能够理解并调用这些服务来完成特定指令，从而极大地扩展了AI助手的能力边界。该项目包含两个主要部分：一个是用于管理和部署工作流的网页平台“Agent Marketplace”，另一个是负责处理具体服务请求的高性能后端“MCP Router”。

功能列表

• 一键转换：将N8N平台创建的自动化工作流，快速转换为MCP（模型上下文协议）服务器。
• AI集成：生成的MCP服务能与支持该协议的AI助手无缝对接，如Claude、Cursor和Super Chain，作为它们的自定义工具使用。
• 双重架构：
  • Agent Marketplace: 提供一个基于网页的用户界面，用于浏览、上传、管理和部署N8N工作流模板。
  • MCP Router: 一个高性能的FastAPI服务，负责创建和路由MCP服务请求，确保AI助手可以稳定调用。
• 凭证管理：在部署工作流时，提供直观的界面来配置和测试所需的API密钥等敏感信息。
• 模板市场：平台内置一个市场，用户可以直接浏览和部署预先构建好的N8T工作流模板。
• 自定义上传：支持用户上传自己创建的N8N工作流JSON文件，并进行实时分析和部署。

使用帮助

N8N2MCP旨在简化将自动化工作流集成为AI工具的过程。以下是详细的安装和使用步骤，帮助你从零开始配置并运行该系统。

前期准备

在开始安装之前，请确保你的系统满足以下条件：

• Python: 版本要求为 3.11 或更高。
• N8N 实例: 你需要有一个正在运行的N8N账户，可以使用官方的云服务 cloud.n8n.io，也可以是自己搭建的服务器。
• Supabase 账户: 用于存储工作流配置和用户数据。
• Playwright: 这是执行N8N认证所必需的工具。如果未正确安装，系统功能将受限。
• Docker: (可选) 如果你希望通过容器化方式部署，需要安装Docker。

安装流程

1. 克隆项目代码首先，从GitHub上克隆N8N2MCP的源代码到你的本地计算机。

   git clone https://github.com/Super-Chain/N8N2MCP.git
   cd N8N2MCP
   

2. 安装依赖库项目所需的Python库都记录在requirements.txt文件中。运行以下命令进行安装：

   pip install -r requirements.txt
   

3. 安装 Playwright 浏览器Playwright是实现N8N自动化登录和操作的关键，必须安装其所需的浏览器文件。

   playwright install
   

   这个命令会自动下载并安装用于自动化任务的浏览器核心。

4. 配置环境变量项目通过一个.env文件来管理所有配置信息。你可以从模板文件.env.example复制一份来进行修改。

   cp .env.example .env
   

   然后，使用文本编辑器打开.env文件，填入你的实际配置信息：

   • Supabase 配置:
     • SUPABASE_URL: 你的Supabase项目URL。
     • SUPABASE_KEY: 你的Supabase项目匿名密钥 (anon key)。
     • SUPABASE_SERVICE_KEY: 你的Supabase项目服务角色密钥 (service_role key)。
   • N8N 配置:
     • X_N8N_API_KEY: 你的N8N实例的API密钥。
     • N8N_BASE_URL: 你的N8N实例的访问地址，必须包含https://。
     • N8N_USERNAME: 登录N8N的用户名。
     • N8N_PASSWORD: 登录N8N的密码。
   • 服务器配置:
     • FLASK_HOST 和 FLASK_PORT: Agent Marketplace服务的地址和端口，默认为 0.0.0.0:5000。
     • MCP_HOST 和 MCP_PORT: MCP Router服务的地址和端口，默认为 0.0.0.0:6545。
     • N8N_BUILDER_URL: MCP Router的访问地址，默认为 http://localhost:6545。
5. 启动服务完成以上所有配置后，运行主启动脚本来同时启动两个核心服务：

   python main.py
   

   该命令会启动：

   • Agent Marketplace: 访问地址为 http://localhost:5000
   • MCP Router: 访问地址为 http://localhost:6545

功能操作流程

方法一：从模板市场导入工作流

1. 浏览模板: 在浏览器中打开 http://localhost:5000，你会看到Agent Marketplace的主界面。
2. 选择模板: 浏览预置的N8N工作流模板，选择一个你感兴趣的。
3. 导入并配置: 输入模板的ID，系统会自动加载模板信息。此时，界面会提示你填写该工作流运行所需的凭证，例如某个应用的API Key或密码。
4. 一键部署: 点击“Deploy”按钮。系统会自动将这个工作流部署到你的N8N实例中，并为其创建一个MCP服务终结点（Endpoint）。
5. 获取MCP链接: 部署成功后，系统会生成一个MCP服务器的URL。这个URL就是提供给AI助手的工具地址。

方法二：上传自定义工作流

1. 准备JSON文件: 在你的N8N实例中，导出你想要部署的工作流为JSON文件。
2. 上传文件: 在Agent Marketplace界面，选择上传自定义工作流，并提交你的JSON文件。
3. 分析与配置: 系统会自动解析你的工作流，识别出其中包含的节点和需要的凭证信息，并要求你填写。
4. 部署和使用: 填写完凭证后，点击部署。流程与方法一相同，系统会自动创建MCP服务，并为你生成可用的URL。

在AI助手（如Claude）中使用

1. 复制MCP链接: 从N8N2MCP的界面复制已经生成的MCP服务器URL。
2. 粘贴到AI工具设置中: 在Claude或其他支持MCP协议的AI平台中，找到自定义工具或函数的设置选项，将复制的URL粘贴进去。
3. 通过自然语言调用: 现在，你可以直接通过对话方式让AI助手使用这个新工具了。例如，如果你的工作流是用来查询天气的，你可以直接问：“今天北京的天气怎么样？” AI会自动调用你部署的N8N工作流来获取答案。

应用场景

1. 数据处理与分析用户可以通过自然语言指令，让AI助手调用N8N工作流来处理上传的CSV或Excel文件。例如，对数据进行排序、筛选，并生成分析报告，整个过程无需手动操作表格软件。
2. 外部服务集成中心将AI助手连接到各种外部API和服务。例如，创建一个工作流，让AI能够直接在Slack或Discord中发送消息，或者从Google Drive、Notion等平台读取和写入数据。
3. 自动化通讯和通知构建一个自动化通知系统。当AI在对话中监测到特定关键词或事件时，可以触发N8N工作流，自动发送邮件、短信或企业微信通知给相关人员。
4. 企业内部流程自动化将复杂的业务流程（如采购审批、报销申请）封装成N8N工作流。员工可以直接通过与AI对话来启动和推进这些流程，AI则负责调用后端服务完成状态更新和任务流转。

QA

1. 这个项目是做什么的？N8N2MCP是一个开源工具，它能把你用N8N创建的自动化工作流，转换成一个可以被AI大模型（比如Claude）当作工具来调用的网络服务。
2. 什么是N8N？N8N是一个可视化的工作流自动化工具，类似于Zapier，但可以免费自托管。你可以通过拖拽不同的功能模块（节点）来创建各种自动化任务。
3. 什么是MCP？MCP（Model Context Protocol）是一种开放标准，它定义了AI模型如何与外部工具或服务进行交互。N8N2MCP创建的服务就遵循这个标准，所以能被支持此协议的AI平台识别和使用。
4. 安装过程中遇到Port Already in Use错误怎么办？这个错误表示服务要使用的端口（如5000或6545）已经被其他程序占用。你可以通过运行命令 fuser -k 5000/tcp 6545/tcp 来强制关闭占用端口的进程，然后重新运行 python main.py。
5. 为什么必须安装Playwright？Playwright是一个浏览器自动化工具。N8N2MCP使用它来模拟用户登录N8N实例，以便进行工作流的部署和凭证的自动配置。如果没有它，系统将无法与你的N8N实例进行安全的交互。