n8n Workflow Builder MCP Server

n8n 工作流构建器 MCP 服务

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

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

📚 目录

• 这是什么？
• 主要功能
• 要求
• 安装与使用
• 配置
• MCP 客户端设置
• 可用工具
• 使用示例
• 故障排除
• 常见问题
• 参与贡献
• 许可证
• 实用链接

📖 补充文档

• 🚀 入门指南 - 5 分钟内快速完成设置
• 💼 真实使用场景 - 电商、数据处理、API 集成等
• 🔍 与替代方案对比 - 与 Zapier、Make.com、n8n Web UI 和 CLI 对比
• 🔧 全面故障排除指南 - 常见故障和问题的解决方案

🎯 这是什么？

n8n Workflow Builder MCP Server 在 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：手动安装

用于开发或自定义：

# Clone the repository
git clone https://github.com/makafeli/n8n-workflow-builder.git
cd n8n-workflow-builder

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

⚙️ 配置

环境变量

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

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

获取 n8n API 密钥

1. 打开您的 n8n 实例
2. 前往 Settings → API Keys
3. 点击 Create API Key
4. 复制生成的密钥

设置环境变量

# For local testing
export N8N_HOST="http://localhost:5678"
export N8N_API_KEY="your-api-key-here"

# Then run the server
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：审计配置

💡 使用示例

基本操作

// List all workflows
await callTool("list_workflows", {});

// Get detailed information about a workflow
await callTool("get_workflow", { id: "workflow-123" });

// Execute a workflow manually
await callTool("execute_workflow", { id: "workflow-123" });

创建工作流

// Create a simple workflow
await callTool("create_workflow", {
  workflow: {
    name: "My Automation Workflow",
    nodes: [
      {
        id: "trigger",
        name: "Schedule Trigger",
        type: "n8n-nodes-base.scheduleTrigger",
        typeVersion: 1,
        position: [240, 300],
        parameters: {
          interval: [{ field: "unit", value: "hours" }]
        }
      },
      {
        id: "action",
        name: "HTTP Request",
        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 }]]
      }
    }
  }
});

工作流管理

// Activate a workflow
await callTool("activate_workflow", { id: "workflow-123" });

// Update a workflow
await callTool("update_workflow", {
  id: "workflow-123",
  workflow: { name: "Updated Workflow Name" }
});

// Deactivate a workflow
await callTool("deactivate_workflow", { id: "workflow-123" });

// Create and immediately activate
await callTool("create_workflow_and_activate", {
  workflow: { /* workflow configuration */ }
});

执行管理 ⭐ 新增

// List recent executions
await callTool("list_executions", {
  limit: 10,
  status: "error"
});

// Get detailed execution information
await callTool("get_execution", {
  id: "execution-123",
  includeData: true
});

// Clean up old execution records
await callTool("delete_execution", { id: "execution-123" });

标签管理 ⭐ 新增

// List all workflow tags
await callTool("list_tags", { limit: 50 });

// Create a new tag for organization
await callTool("create_tag", { name: "production" });

安全审计 ⭐ 新增

// Generate comprehensive security audit
await callTool("generate_audit", {
  additionalOptions: {
    daysAbandonedWorkflow: 30,
    categories: ["credentials", "database", "nodes"]
  }
});

🔧 故障排除

常见问题

“Connection refused”或“ECONNREFUSED”

• 原因：无法连接到你的 n8n 实例
• 解决方案：确认 N8N_HOST 正确且 n8n 正在运行
• 检查：先尝试在浏览器中访问你的 n8n 实例

“Unauthorized”或“401 Error”

• 原因：API 密钥无效或缺失
• 解决方案：
  1. 确认 N8N_API_KEY 正确
  2. 确保 API 密钥具有适当的权限
  3. 检查 API 密钥是否已过期

“Workflow not found”或“404 Error”

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

服务无法启动

• 原因：缺少 Node.js 或依赖项
• 解决方案：
  1. 确保已安装 Node.js v18+：node --version
  2. 尝试清理 npm 缓存：npm cache clean --force
  3. 如需手动安装，请运行：npm install && npm run build

调试模式

如需详细日志，请设置调试环境变量：

DEBUG=n8n-workflow-builder npx @makafeli/n8n-workflow-builder

获取帮助

1. 查看 GitHub Issues
2. 查阅 n8n 的 API 文档
3. 检查你的 MCP 客户端配置

❓ 常见问题

什么是 MCP 服务？

Model Context Protocol (MCP) 服务是一种标准化方式，使 AI 助手能够访问外部工具和数据源。此 MCP 服务专门为 AI 助手提供与 n8n 工作流交互的能力，让助手能够通过自然语言命令自动管理工作流。

如何将 AI 助手连接到 n8n 工作流？

此 MCP 服务充当 AI 助手（如 Claude Desktop、Cline 或 ChatGPT）与您的 n8n 实例之间的桥梁。只需：

1. 安装 MCP 服务：npx @makafeli/n8n-workflow-builder
2. 使用您的 n8n 凭据配置 AI 助手的 MCP 设置
3. 开始使用自然语言管理 n8n 工作流

哪些 AI 助手可以与此 MCP 服务配合使用？

此服务适用于任何 兼容 MCP 的 AI 助手，包括：

• Claude Desktop（Anthropic）
• Cline（VS Code 扩展）
• Continue（VS Code 扩展）
• 任何自定义 MCP 客户端实现
• 未来兼容 MCP 的 AI 助手

我可以将它用于 n8n Cloud，还是只能用于可自托管实例？

此 MCP 服务适用于 n8n Cloud 和可自托管实例。您只需要：

• 您的 n8n 实例 URL（云端或可自托管）
• 具有适当权限的有效 n8n API 密钥
• 运行 MCP 服务的位置能够访问网络

AI 助手可以对我的 n8n 工作流执行哪些操作？

AI 助手可以执行 完整的工作流管理，包括：

• 列出和浏览现有工作流
• 使用复杂的节点配置创建新工作流
• 手动或按需执行工作流
• 激活／停用工作流
• 更新和修改现有工作流
• 监控执行状态并检索详细日志
• 管理工作流标签和组织方式
• 生成安全审计和合规报告

这安全吗？需要哪些权限？

此 MCP 服务使用 n8n 官方 API 并进行适当的身份验证：

• 需要有效的 n8n API 密钥（权限由您控制）
• MCP 服务不会存储任何数据
• 所有通信都直接在您的 AI 助手与 n8n 之间进行
• 遵循 n8n 的安全模型和访问控制
• 您可以随时禁用 API 密钥以撤销访问权限

这与使用 n8n 网页界面有何不同？

此 MCP 服务支持 AI 驱动的工作流管理：

• 使用自然语言命令，无需在 UI 中逐步点击
• 根据描述自动创建工作流
• 跨多个工作流执行批量操作
• 与 AI 助手工作流和自动化集成
• 通过 AI 助手使用语音命令
• 获取 AI 提供的上下文帮助和建议

🔍 详细比较：请参阅我们的比较指南，了解与 n8n Web UI、CLI、Zapier 和 Make.com 的详细比较。

我可以使用 AI 自动创建工作流吗？

可以！这是核心功能之一。您可以：

• 使用自然语言描述工作流，让 AI 创建工作流
• 根据需求或用例生成工作流
• 通过对话式命令修改现有工作流
• 自动创建工作流模板和变体
• 使用不同参数批量创建类似的工作流

💼 实际示例：请参阅我们的用例指南，了解不同行业的具体自动化示例。

遇到问题或错误时该怎么办？

常见解决方案：

1. 检查您的 n8n API 密钥——确保密钥有效且具有适当权限
2. 验证 n8n 实例 URL——确保该 URL 正确且可访问
3. 查看上方的故障排除部分，查找具体错误消息
4. 查看 GitHub Issues，了解已知问题和解决方案
5. 使用 DEBUG=n8n-workflow-builder 启用调试模式以查看详细日志

🔧 全面帮助：请参阅我们的故障排除指南，了解常见问题的详细解决方案。

如何快速开始？

最快的设置方式：

1. 使用 Smithery.ai 托管版本（无需安装）：smithery.ai
2. 或在本地运行：npx @makafeli/n8n-workflow-builder
3. 配置 AI 助手并提供你的 n8n 凭据
4. 从简单命令开始，例如“列出我的工作流”或“显示工作流详情”

📖 详细指南：查看我们的入门指南，了解分步设置说明。

我可以为这个 MCP 服务做贡献或进行自定义吗？

当然可以！这是一个开源项目：

• Fork 此仓库以进行自定义
• 提交拉取请求以改进项目
• 在 GitHub 上报告问题或请求新功能
• 通过添加新的 MCP 工具来扩展功能
• 与社区分享用例和示例

🤝 贡献

欢迎贡献！

📄 许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

🔗 实用链接

• n8n 文档 - n8n 官方文档
• Model Context Protocol - MCP 规范
• Claude Desktop - 支持 MCP 的 AI 助手
• Cline - VS Code AI 助手
• GitHub 仓库 - 源代码和问题

---

用 ❤️ 为 n8n 和 MCP 社区打造

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "n8n Workflow Builder MCP Server",
  "description": "AI assistant integration for n8n workflow automation through the Model Context Protocol (MCP). Connect Claude Desktop, ChatGPT, and other AI assistants to n8n for natural language workflow management.",
  "url": "https://github.com/makafeli/n8n-workflow-builder",
  "downloadUrl": "https://www.npmjs.com/package/@makafeli/n8n-workflow-builder",
  "applicationCategory": "DeveloperApplication",
  "operatingSystem": "Cross-platform",
  "programmingLanguage": "TypeScript",
  "author": {
    "@type": "Person",
    "name": "makafeli",
    "url": "https://github.com/makafeli"
  },
  "license": "https://github.com/makafeli/n8n-workflow-builder/blob/main/LICENSE",
  "keywords": [
    "n8n",
    "MCP",
    "AI assistant",
    "workflow automation",
    "Claude Desktop",
    "ChatGPT",
    "Model Context Protocol"
  ],
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD"
  },
  "softwareRequirements": "Node.js 18.0.0 or higher",
  "releaseNotes": "https://github.com/makafeli/n8n-workflow-builder/releases",
  "codeRepository": "https://github.com/makafeli/n8n-workflow-builder"
}