mcp-n8n-builder

mcp-n8n-builder

一个模型上下文协议 (MCP) 服务器，用于以编程方式创建和管理 n8n 工作流。该服务器提供与 n8n REST API 交互的工具和资源，使 AI 助手无需用户直接干预即可构建、修改和管理工作流。

特征

• 🔄工作流管理：创建、读取、更新、删除、激活和停用工作流
• 📊执行管理：列出并检索工作流执行详细信息
• ✅模式验证：使用 Zod 对输入和输出数据进行全面验证
• 🔍节点验证：在创建工作流之前根据 n8n 的可用节点验证节点类型，以防止出现错误
• 🤔智能建议：当检测到无效节点时，提供类似节点类型的建议
• 🛠️错误处理：用于故障排除的详细错误消息
• 📝文档：所有工具和资源的详尽文档
• 🔍搜索和过滤：按名称、标签或活动状态过滤工作流程

配置

此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境的示例：

克莱恩配置

将其添加到您的 Cline MCP 设置中：

带有 WSL 配置的 Claude 桌面

对于 WSL 环境，将其添加到您的 Claude Desktop 配置中：

环境变量

可以使用环境变量来配置服务器：

MCP 工具

节点管理

• list_available_nodes ：列出 n8n 实例中所有可用的节点。重要提示：在创建或更新工作流之前使用此工具，以确保仅使用有效的节点类型。这有助于防止因使用当前 n8n 实例中不存在的节点类型而导致的错误。

工作流管理

• list_workflows ：列出 n8n 的所有工作流及其基本信息，包括 ID、名称、状态、创建日期和标签。结果可以按活动状态、标签或名称进行筛选。
• create_workflow ：在 n8n 中创建一个包含指定节点和连接的新工作流。返回已创建的工作流及其指定的 ID。验证所有节点类型是否存在于 n8n 实例中。
• get_workflow ：通过 ID 检索特定工作流的完整详细信息，包括所有节点、连接、设置和元数据。
• update_workflow ：使用新配置更新现有工作流。必须提供完整的工作流结构，而不仅仅是更改的部分。验证 n8n 实例中是否存在所有节点类型。
• delete_workflow ：根据 ID 永久删除工作流。此操作不可撤消。
• activate_workflow ：通过 ID 激活工作流，使其能够根据触发器自动运行。
• deactivate_workflow ：通过 ID 停用工作流，防止其自动运行。

执行管理

• list_executions ：列出工作流执行历史记录，其中包含成功/失败状态、持续时间和时间戳的详细信息。结果可以按工作流 ID、状态进行筛选，并限制为特定数量。
• get_execution ：检索有关特定工作流执行的详细信息，包括执行时间、状态以及可选的每个步骤处理的完整数据。

MCP 资源

• n8n://workflows ：n8n 中所有工作流程的列表
• n8n://workflows/{id} ：特定 n8n 工作流的详细信息
• n8n://executions/{id} ：特定 n8n 工作流执行的详细信息

发展

设置

1. 克隆存储库
2. 安装依赖项：

3. 构建项目：

4. 以开发模式运行：

出版

该项目使用变更集进行版本管理。要发布：

1. 创建变更集：

2. 对包进行版本控制：

3. 发布到 npm：

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

MIT 许可证 - 有关详细信息，请参阅LICENSE文件。

致谢

• 基于模型上下文协议
• 由n8n提供支持