Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client