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,需要在本地或服务器上完成安装和配置。以下是详细步骤:
- 克隆代码库
在终端运行以下命令,将 N8N2MCP 项目克隆到本地:git clone https://github.com/Super-Chain/N8N2MCP.git cd N8N2MCP
- 安装依赖
使用 Python 包管理器安装项目所需依赖:pip install -r requirements.txt
- 安装 Playwright 浏览器
N8N2MCP 依赖 Playwright 进行 n8n 的认证和自动化操作。运行以下命令安装浏览器二进制文件:playwright install
注意:如果未正确安装 Playwright,系统将使用默认凭证,导致功能受限。
- 配置环境变量
复制示例环境配置文件并进行编辑: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 服务可访问。
- Supabase 配置:
- 运行 MCP 路由器
启动 MCP 路由器以处理请求:cd mcp_router python mcp_router.py --log-level debug
调试模式(
--log-level debug
)可查看详细日志,便于排查问题。 - 测试组件
测试工作流解析器和 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
文件中的所有配置项,避免因配置错误导致部署失败。
应用场景
- 自动化营销任务
开发者可以将 n8n 工作流设计为自动化发送营销邮件或分析用户数据,转换为 MCP 服务器后,AI 助手可根据客户行为触发个性化邮件发送。 - 数据处理与集成
数据分析师可使用 N8N2MCP 将复杂的数据处理流程(如从 API 抓取数据并存储到数据库)部署为 MCP 服务器,供 AI 助手调用以生成报告。 - AI 助手增强
Claude 或 Cursor 用户可通过 N8N2MCP 扩展 AI 功能,例如将 n8n 工作流集成到 AI 助手中,实现文件管理、数据分析或代码生成。 - 快速原型开发
初创公司可利用 N8N2MCP 快速部署自动化原型,测试业务流程,并通过 AI 助手验证功能可行性。
QA
- N8N2MCP 支持哪些 AI 助手?
目前支持 Claude、Cursor 和 Super Chain 等兼容 MCP 协议的 AI 助手。未来可能扩展到更多平台。 - 是否需要 n8n 专业知识才能使用?
需要基本了解 n8n 的工作流创建,但 N8N2MCP 的 Web 界面简化了部署过程,无需深入编程知识。 - 如何确保服务器安全性?
建议使用 HTTPS、定期轮换 API 密钥、启用 RLS 策略,并避免在服务器端存储用户凭证。 - 如果 Playwright 安装失败怎么办?
检查网络连接,确保运行playwright install
命令。如果失败,可尝试手动下载浏览器二进制文件,或联系社区支持。