N8n Builder MCP

n8n生成器MCP

MCP服务器，用于通过Cloudflare Workers进行程序化n8n工作流控制。

📖 CTO指南： 看 docs/CTO_GUIDE.md 获取全面的使用文档。

概述

此MCP提供了17个用于管理n8n工作流的工具：

第1层：核心CRUD（7个工具）

• n8n_list_workflows -列出所有工作流
• n8n_get_workflow -获取工作流程JSON
• n8n_create_workflow -从JSON创建
• n8n_update_workflow -完全替换
• n8n_delete_workflow -删除工作流
• n8n_activate_workflow -设置活动=真
• n8n_deactivate_workflow -设置活动=假

第2层：外科编辑（5种工具）

• n8n_add_node -将节点添加到工作流
• n8n_update_node -更新节点参数
• n8n_remove_node -删除节点+连接
• n8n_add_connection -连接两个节点
• n8n_remove_connection -解开节点

第3层：执行（3个工具）

• n8n_execute_workflow -触发器执行
• n8n_list_executions -获取执行历史记录
• n8n_get_execution -获取执行详细信息

第4层：发现（2个工具）

• n8n_list_node_types -列出可用节点
• n8n_get_node_type -获取节点架构

建筑

Claude.ai ──OAuth──> n8n-builder-mcp (CF Worker) ──API Key──> n8n Instance

设置

1.创建KV命名空间

npx wrangler kv namespace create OAUTH_KV
# Update wrangler.jsonc with the ID

2.创建GitHub OAuth应用程序

在github上/设置/开发者：

• 姓名： n8n Builder MCP
• 主页： https://n8n-builder-mcp.cognitive-tech.workers.dev
• 回拨： https://n8n-builder-mcp.cognitive-tech.workers.dev/callback

3.设定秘密

npx wrangler secret put GITHUB_CLIENT_ID
npx wrangler secret put GITHUB_CLIENT_SECRET
npx wrangler secret put COOKIE_ENCRYPTION_KEY  # openssl rand -hex 32
npx wrangler secret put N8N_API_KEY
npx wrangler secret put N8N_BASE_URL           # e.g., https://your-n8n.example.com

4.部署

npm install
npx wrangler deploy

5.在Claude.ai中连接

使用URL添加为MCP连接器： https://n8n-builder-mcp.cognitive-tech.workers.dev/sse

安全

• GitHub OAuth用于用户身份验证
• 允许列表：仅 OscarsOrbit 和 _service 用户
• n8n API密钥存储为Cloudflare机密
• 可选的SERVICE_KEY用于无头访问

发展

npm install
npm run dev    # Local development
npm run deploy # Deploy to Cloudflare