返回 MCP 目录
public公开dns本地运行

mcp-n8n-workflow-builder

该项目提供了一个基于MCP协议的n8n工作流管理服务器,支持通过自然语言创建、更新、删除和激活工作流,并与Claude AI和Cursor IDE深度集成。

article

README

🚀 工作流管理系统

本项目提供了一套强大的工作流管理解决方案,具备丰富的工作流模板、执行跟踪和错误处理机制,能帮助用户更高效地创建和管理工作流。

🚀 快速开始

配置环境变量

  • N8N_HOST:指定n8n实例的URL地址。
  • N8N_API_KEY:用于身份验证的API密钥,需在n8n中启用。

启动服务器

node build/index.js

创建工作流

使用提供的模板或自定义配置创建工作流,并通过HTTP API进行发布和管理。

激活工作流

根据工作流的触发类型(如计划任务、Webhook),设置相应的触发条件以启动执行。

✨ 主要特性

  • 工作流模板:包括用于HTTP请求、文件操作、API数据轮询等任务的预定义节点。
  • 工作流执行跟踪:通过唯一标识符和时间戳记录每次工作流运行的状态,便于后续分析和调试。
  • 错误处理与恢复:自动检测节点执行失败的情况,并提供重试机制以确保任务顺利完成。

📚 详细文档

错误处理

  • 认证错误:当API请求返回401状态码时,检查API密钥是否正确且有效。
  • 端点不可用:如果n8n服务暂时不可用,请稍后重试或查看n8n的日志信息。

版本兼容性

  • 支持的n8n版本:1.82.3及以上。
  • Node.js要求:v14及以上版本。

更新日志

0.7.2(当前版)

  • 解决了处理工作流节点参数时出现的验证错误。
  • 提升了对端口冲突的处理能力,支持多实例运行。
  • 优化了服务器启动的稳定性,确保在高负载情况下仍能正常运作。

0.7.1

  • 增加了对n8n API限制和已知问题的详细说明。
  • 更新了故障排除部分,增加了针对特定错误代码的解决方案。
  • 提升了文档的质量,使其更具可读性和参考价值。

0.7.0

  • 改进了触发节点的检测与兼容性,确保与n8n 1.82.3无缝集成。
  • 增强了工作流激活功能,支持多种触发类型(计划任务、Webhook)。

📄 许可证

本项目遵循MIT许可证分发。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端