n8n Workflow Builder MCP Server

基本能力

产品定位

mcp-n8n-workflow-builder 是一个工作流管理工具，专注于通过自然语言和 AI 辅助来简化和自动化 n8n 工作流的创建和管理过程。

核心功能

• 工作流管理：创建、更新、删除、激活和停用 n8n 工作流
• 执行管理：查看和管理工作流执行记录
• 标签管理：创建、更新和删除工作流标签
• 预定义模板：提供多种工作流模板，如定时触发、HTTP Webhook、数据转换等
• AI 集成：与 Claude AI 和 Cursor IDE 深度集成，支持自然语言交互

适用场景

• 自动化业务流程
• 数据集成和转换
• API 数据轮询和处理
• 外部服务集成
• 定时任务管理

工具列表

工作流管理工具

• list_workflows: 列出所有工作流
• create_workflow: 创建新工作流
• get_workflow: 获取工作流详情
• update_workflow: 更新工作流
• delete_workflow: 删除工作流
• activate_workflow: 激活工作流
• deactivate_workflow: 停用工作流
• execute_workflow: 手动执行工作流

执行管理工具

• list_executions: 列出执行记录
• get_execution: 获取执行详情
• delete_execution: 删除执行记录

标签管理工具

• create_tag: 创建标签
• get_tags: 获取所有标签
• get_tag: 获取标签详情
• update_tag: 更新标签
• delete_tag: 删除标签

常见问题解答

1. 端口冲突问题：

2. 解决方案：使用 MCP_PORT 环境变量指定不同端口

3. 认证错误：

4. 检查 API 密钥是否正确且未过期

5. 确保 n8n 实例已启用 API 访问

6. 工作流激活问题：

7. 确保工作流包含有效的触发节点

8. 服务会自动添加 scheduleTrigger 节点（如需要）

9. 标签冲突：

10. 服务使用 UUID 生成标签名以避免冲突

使用教程

使用依赖

• Node.js (v14+ 推荐)
• npm
• 可访问的 n8n 实例（版本 1.82.3 测试通过）
• Claude App 或 Cursor IDE 用于 AI 交互

安装教程

1. 通过 npm 安装（推荐）

# 全局安装
npm install -g @kernel.salacoste/n8n-workflow-builder

# 或作为本地依赖安装
npm install @kernel.salacoste/n8n-workflow-builder

2. 克隆仓库

git clone https://github.com/salacoste/mcp-n8n-workflow-builder.git
cd mcp-n8n-workflow-builder

3. 安装依赖

npm install

4. 配置环境变量

创建 .env 文件并添加：

N8N_HOST=https://your-n8n-instance.com/api/v1/
N8N_API_KEY=your_api_key_here

5. 构建和运行

# 构建项目
npm run build

# 启动 MCP 服务器
npm start

# 使用 JSON-RPC 模式测试
npm run start -- --json-rpc

调试方式

1. 运行测试脚本验证功能：

node test-mcp-tools.js

1. 检查日志中的错误信息

2. 使用 --json-rpc 标志启动服务并通过 curl 发送测试请求

3. 清理并重建项目：

npm run clean && npm run build

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。