基本能力
产品定位
mcp-n8n-builder 是一个用于自动化创建和管理 n8n 工作流的 MCP 服务,旨在通过编程方式简化工作流的构建和管理过程。
核心功能
- 工作流管理:创建、读取、更新、删除、激活和停用工作流。
- 执行管理:列出和检索工作流执行的详细信息。
- 模式验证:使用 Zod 对输入和输出数据进行全面验证。
- 节点验证:在工作流创建前验证节点类型,防止错误。
- 智能建议:在检测到无效节点时提供相似节点类型的建议。
- 错误处理:详细的错误消息,便于故障排除。
- 文档:所有工具和资源的详细文档。
- 搜索和过滤:按名称、标签或活动状态过滤工作流。
适用场景
- 自动化构建和管理 n8n 工作流。
- 通过编程方式集成 n8n 工作流到其他系统中。
- 在 AI 助手的帮助下快速创建和修改工作流。
工具列表
- 节点管理:
list_available_nodes
:列出 n8n 实例中所有可用的节点。- 工作流管理:
list_workflows
:列出所有工作流的基本信息。create_workflow
:创建新工作流。get_workflow
:检索特定工作流的详细信息。update_workflow
:更新现有工作流。delete_workflow
:删除工作流。activate_workflow
:激活工作流。deactivate_workflow
:停用工作流。- 执行管理:
list_executions
:列出工作流执行历史。get_execution
:检索特定工作流执行的详细信息。
常见问题解答
- 如何配置服务器:通过 MCP 客户端配置,提供示例配置。
- 环境变量:详细列出可配置的环境变量及其默认值。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 克隆仓库:
bash
git clone <repository-url>
安装教程
- 进入项目目录:
bash
cd mcp-n8n-builder - 安装依赖:
bash
npm install - 构建项目:
bash
npm run build - 运行开发模式:
bash
npm run dev
调试方式
- 确保 n8n 实例运行并配置正确的
N8N_HOST
和N8N_API_KEY
。 - 使用
list_workflows
工具验证连接:
bash
npm run dev -- --tool list_workflows - 检查日志输出以确认服务器正常运行。