基本能力
产品定位
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
: 删除标签
常见问题解答
- 端口冲突问题:
-
解决方案:使用
MCP_PORT
环境变量指定不同端口 -
认证错误:
- 检查 API 密钥是否正确且未过期
-
确保 n8n 实例已启用 API 访问
-
工作流激活问题:
- 确保工作流包含有效的触发节点
-
服务会自动添加
scheduleTrigger
节点(如需要) -
标签冲突:
- 服务使用 UUID 生成标签名以避免冲突
使用教程
使用依赖
- Node.js (v14+ 推荐)
- npm
- 可访问的 n8n 实例(版本 1.82.3 测试通过)
- Claude App 或 Cursor IDE 用于 AI 交互
安装教程
1. 通过 npm 安装(推荐)
```bash
全局安装
npm install -g @kernel.salacoste/n8n-workflow-builder
或作为本地依赖安装
npm install @kernel.salacoste/n8n-workflow-builder
```
2. 克隆仓库
bash
git clone https://github.com/salacoste/mcp-n8n-workflow-builder.git
cd mcp-n8n-workflow-builder
3. 安装依赖
bash
npm install
4. 配置环境变量
创建 .env
文件并添加:
N8N_HOST=https://your-n8n-instance.com/api/v1/
N8N_API_KEY=your_api_key_here
5. 构建和运行
```bash
构建项目
npm run build
启动 MCP 服务器
npm start
使用 JSON-RPC 模式测试
npm run start -- --json-rpc
```
调试方式
-
运行测试脚本验证功能:
bash
node test-mcp-tools.js -
检查日志中的错误信息
-
使用
--json-rpc
标志启动服务并通过 curl 发送测试请求 -
清理并重建项目:
bash
npm run clean && npm run build