STARWARCLOUD STARWAR.AI
返回市场
n8n工作流构建器

n8n工作流构建器

作者：makafeli424 星标更新：2025-08-04
安装使用来源：spider==github.com

项目介绍

n8n 工作流构建器 MCP 服务器

<!-- 社交媒体预览元标签 --> <meta property="og:title" content="n8n 工作流构建器 MCP 服务器 - n8n 自动化集成的 AI 助手"> <meta property="og:description" content="将 Claude Desktop、ChatGPT 和其他 AI 助手直接连接到您的 n8n 实例，通过自然语言命令无缝管理、创建和执行工作流。"> <meta property="og:image" content="https://raw.githubusercontent.com/makafeli/n8n-workflow-builder/main/.github/assets/social-preview.png"> <meta property="og:url" content="https://github.com/makafeli/n8n-workflow-builder"> <meta property="og:type" content="website"> <meta property="twitter:card" content="summary_large_image"> <meta property="twitter:title" content="n8n 工作流构建器 MCP 服务器 - AI 助手集成"> <meta property="twitter:description" content="将 Claude Desktop 等 AI 助手连接到 n8n，通过对话进行自然语言工作流自动化。创建、管理和执行工作流。"> <meta property="twitter:image" content="https://raw.githubusercontent.com/makafeli/n8n-workflow-builder/main/.github/assets/social-preview.png">

n8n 工作流自动化的终极 AI 助手集成 - 将 Claude Desktop、ChatGPT 和其他 AI 助手直接连接到您的 n8n 实例，通过模型上下文协议（MCP）无缝管理、创建和执行工作流。

<div align="center"> <a href="https://smithery.ai/server/@makafeli/n8n-workflow-builder"> <img src="https://smithery.ai/badge/@makafeli/n8n-workflow-builder" alt="Smithery 服务器徽章"> </a>

<br><br>

<!-- 包和仓库统计 --> <a href="https://www.npmjs.com/package/@makafeli/n8n-workflow-builder"> <img src="https://img.shields.io/npm/v/@makafeli/n8n-workflow-builder?style=flat-square&logo=npm&color=CB3837" alt="npm 版本"> </a> <a href="https://www.npmjs.com/package/@makafeli/n8n-workflow-builder"> <img src="https://img.shields.io/npm/dm/@makafeli/n8n-workflow-builder?style=flat-square&logo=npm&color=CB3837" alt="npm 下载量"> </a> <a href="https://github.com/makafeli/n8n-workflow-builder"> <img src="https://img.shields.io/github/stars/makafeli/n8n-workflow-builder?style=flat-square&logo=github&color=181717" alt="GitHub 星数"> </a> <a href="https://github.com/makafeli/n8n-workflow-builder/network/members"> <img src="https://img.shields.io/github/forks/makafeli/n8n-workflow-builder?style=flat-square&logo=github&color=181717" alt="GitHub 分支"> </a> <br> <!-- 构建与质量徽章 --> <a href="https://github.com/makafeli/n8n-workflow-builder/actions"> <img src="https://img.shields.io/github/actions/workflow/status/makafeli/n8n-workflow-builder/ci.yml?style=flat-square&logo=github-actions&label=测试" alt="CI 状态"> </a> <a href="https://github.com/makafeli/n8n-workflow-builder/blob/main/LICENSE"> <img src="https://img.shields.io/github/license/makafeli/n8n-workflow-builder?style=flat-square&color=green" alt="许可证"> </a> <a href="https://nodejs.org/"> <img src="https://img.shields.io/node/v/@makafeli/n8n-workflow-builder?style=flat-square&logo=node.js&color=339933" alt="Node.js 版本"> </a> <a href="https://www.typescriptlang.org/"> <img src="https://img.shields.io/badge/TypeScript-就绪-blue?style=flat-square&logo=typescript" alt="TypeScript"> </a> <br> <!-- 平台集成徽章 --> <a href="https://glama.ai/mcp/servers/fhoynrlnpp"> <img src="https://gips2.baidu.com/it/u=5361532,4156176336&fm=3081&app=3081&f=PNG?w=760&h=400" alt="n8n 工作流构建器 MCP 服务器" height="40"> </a> &nbsp; <a href="https://mseep.ai/app/makafeli-n8n-workflow-builder"> <img src="https://gips3.baidu.com/it/u=2374926826,346646123&fm=3081&app=3081&f=PNG?w=511&h=180" alt="MseeP.ai 安全评估徽章" height="40"> </a> </div>

一个强大的模型上下文协议（MCP）服务器，使 AI 助手能够无缝管理 n8n 工作流。将您的 AI 工具直接连接到 n8n，实现工作流的自动化创建、执行和管理。

📚 目录

📖 额外文档

🎯 这是什么？

n8n 工作流构建器 MCP 服务器弥合了 AI 助手（如 Claude Desktop、Cline 或任何 MCP 兼容客户端）与您的 n8n 自动化平台之间的差距。它提供了一整套工具，允许 AI 助手：

  • 列出和浏览您现有的 n8n 工作流
  • 创建新的工作流具有复杂的节点配置
  • 按需执行工作流
  • 管理工作流生命周期（激活、停用、更新、删除）
  • 监控工作流状态并检索详细信息

非常适合使用 n8n 的团队，希望利用 AI 助手进行工作流自动化和管理。

✨ 关键特性

  • 🔧 完整的工件管理 - n8n 工作流的完整 CRUD 操作
  • 🤖 AI 优先设计 - 特别为 AI 助手集成而设计
  • 🚀 零配置 - 使用 NPX 即可运行
  • 🔒 安全 - 使用 n8n 的官方 API 并进行适当的身份验证
  • 📦 现代架构 - 使用 TypeScript 和最新的 MCP SDK 构建
  • ⚡ 高性能 - 优化以实现快速响应时间

📋 需求

  • Node.js v18.0.0 或更高版本
  • n8n 实例（自托管或云）
  • n8n API 密钥具有适当的权限

🚀 安装与使用

方法 1：Smithery.ai（托管 - 推荐）

使用 Smithery.ai 上的托管版本 - 不需要安装：

  1. 访问：smithery.ai
  2. 搜索："n8n-workflow-builder"
  3. 连接：使用您的 n8n 主机和 API 密钥进行配置
  4. 使用：从任何 MCP 兼容的 AI 助手访问

优点：无需本地设置，自动更新，专业托管，工具游乐场。

方法 2：NPX（本地）

使用 NPX 本地运行：

npx @makafeli/n8n-workflow-builder

方法 2：手动安装

用于开发或定制：

# 克隆仓库
git clone https://github.com/makafeli/n8n-workflow-builder.git
cd n8n-workflow-builder

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

⚙️ 配置

环境变量

配置以下环境变量以连接到您的 n8n 实例：

变量描述示例
N8N_HOST您的 n8n 实例 URLhttp://localhost:5678 或 https://your-n8n.com/api/v1
N8N_API_KEY您的 n8n API 密钥n8n_api_1234567890abcdef...

获取您的 n8n API 密钥

  1. 打开您的 n8n 实例
  2. 转到 设置 → API 密钥
  3. 点击 创建 API 密钥
  4. 复制生成的密钥

设置环境变量

# 用于本地测试
export N8N_HOST="http://localhost:5678"
export N8N_API_KEY="your-api-key-here"

# 然后运行服务器
npx @makafeli/n8n-workflow-builder

🔧 MCP 客户端设置

Claude Desktop

在您的 claude_desktop_config.json 中添加此配置：

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@makafeli/n8n-workflow-builder"],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline (VS Code 扩展)

在您的 Cline MCP 设置中添加此内容：

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@makafeli/n8n-workflow-builder"],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

其他 MCP 客户端

该服务器与任何 MCP 兼容客户端兼容。使用与您的客户端特定设置方法相同的配置模式。

🛠️ 可用工具

MCP 服务器提供了 15 个全面的工具，用于完整的 n8n 工作流和执行管理：

核心工作流操作

工具描述参数
list_workflows列出您的 n8n 实例中的所有工作流无
get_workflow检索特定工作流的详细信息id: 工作流 ID（字符串）
create_workflow创建带有节点和连接的新工作流workflow: 工作流对象
execute_workflow手动执行工作流id: 工作流 ID（字符串）

工作流生命周期管理

工具描述参数
update_workflow更新现有工作流的配置id: 工作流 ID，workflow: 更新的工作流对象
activate_workflow激活工作流以启用自动执行id: 工作流 ID（字符串）
deactivate_workflow停用工作流以停止自动执行id: 工作流 ID（字符串）
delete_workflow永久删除工作流id: 工作流 ID（字符串）

高级操作

工具描述参数
create_workflow_and_activate创建新工作流并立即激活workflow: 工作流对象

执行管理 ⭐ 新功能

工具描述参数
list_executions列出工作流执行情况，支持过滤和分页includeData, status, workflowId, projectId, limit, cursor
get_execution获取特定执行的详细信息id: 执行 ID，includeData: 是否包含详细数据
delete_execution删除工作流执行记录id: 执行 ID

标签管理 ⭐ 新功能

工具描述参数
list_tags列出所有工作流标签，支持分页limit, cursor
create_tag创建新的工作流标签以组织name: 标签名

安全与合规性 ⭐ 新功能

工具描述参数
generate_audit生成全面的安全审计报告additionalOptions: 审计配置

💡 使用示例

基本操作

// 列出所有工作流
await callTool("list_workflows", {});

// 获取特定工作流的详细信息
await callTool("get_workflow", { id: "workflow-123" });

// 手动执行工作流
await callTool("execute_workflow", { id: "workflow-123" });

创建工作流

// 创建简单的流程
await callTool("create_workflow", {
  workflow: {
    name: "我的自动化工作流",
    nodes: [
      {
        id: "trigger",
        name: "计划触发器",
        type: "n8n-nodes-base.scheduleTrigger",
        typeVersion: 1,
        position: [240, 300],
        parameters: {
          interval: [{ field: "unit", value: "hours" }]
        }
      },
      {
        id: "action",
        name: "HTTP 请求",
        type: "n8n-nodes-base.httpRequest",
        typeVersion: 4,
        position: [460, 300],
        parameters: {
          url: "https://api.example.com/webhook",
          method: "POST"
        }
      }
    ],
    connections: {
      "Schedule Trigger": {
        "main": [[{ "node": "HTTP Request", "type": "main", "index": 0 }]]
      }
    }
  }
});

工作流管理

// 激活工作流
await callTool("activate_workflow", { id: "workflow-123" });

// 更新工作流
await callTool("update_workflow", {
  id: "workflow-123",
  workflow: { name: "更新的工作流名称" }
});

// 停用工作流
await callTool("deactivate_workflow", { id: "workflow-123" });

// 创建并立即激活
await callTool("create_workflow_and_activate", {
  workflow: { /* 工作流配置 */ }
});

执行管理 ⭐ 新功能

// 列出最近的执行
await callTool("list_executions", {
  limit: 10,
  status: "error"
});

// 获取详细的执行信息
await callTool("get_execution", {
  id: "execution-123",
  includeData: true
});

// 清理旧的执行记录
await callTool("delete_execution", { id: "execution-123" });

标签管理 ⭐ 新功能

// 列出所有工作流标签
await callTool("list_tags", { limit: 50 });

// 创建新的标签以组织
await callTool("create_tag", { name: "生产" });

安全审计 ⭐ 新功能

// 生成全面的安全审计
await callTool("generate_audit", {
  additionalOptions: {
    daysAbandonedWorkflow: 30,
    categories: ["credentials", "database", "nodes"]
  }
});

🔧 故障排除

常见问题

"连接被拒绝"或"ECONNREFUSED"

  • 原因：无法连接到您的 n8n 实例
  • 解决办法：验证您的 N8N_HOST 是否正确且 n8n 正在运行
  • 检查：首先尝试在浏览器中访问您的 n8n 实例

"未经授权"或"401 错误"

  • 原因：无效或缺少 API 密钥
  • 解决办法：
    1. 验证您的 N8N_API_KEY 是否正确
    2. 确保 API 密钥具有适当的权限
    3. 检查 API 密钥是否未过期

"找不到工作流"或"404 错误"

  • 原因：工作流 ID 不存在
  • 解决办法：使用 list_workflows 获取有效的工作流 ID

服务器无法启动

  • 原因：缺少 Node.js 或依赖项
  • 解决办法：