n8n 工作流构建器 MCP 服务器

本项目提供了一个 MCP 服务器，用于管理 n8n 工作流。它提供了一系列定义好的工具，用于列出、创建、更新、删除、激活和停用工作流。

重要提示： 此版本仅支持使用 npm 进行包管理和运行服务器。（npx 支持将在未来的更新中重新引入。）

要求

• Node.js (推荐 v14+)
• npm

详细安装指南

1. 克隆仓库

从您喜欢的来源克隆仓库。例如：

git clone https://github.com/makafeli/n8n-workflow-builder.git

然后，导航到项目目录：

cd /root/n8n-workflow-builder

2. 安装依赖

使用 npm 安装必要的依赖项：

npm install

此命令将下载并安装 package.json 文件中定义的所有必需包。

3. 构建和测试

为了测试并使服务器上线，请使用以下命令：

• 构建项目： 这将编译 TypeScript 文件，并在 build 目录中生成可执行的 JavaScript。

  npm run build
  

• 启动 MCP 服务器： 使用以下命令启动服务器：

  npm start
  

服务器将启动并通过 stdio 连接。您可以查看控制台消息，以确认服务器已正确启动。

4. 部署

为了测试目的并使服务器上线，请使用上面提到的构建和启动命令。目前推荐使用这种基本的工作流程（安装、构建、启动）。

5. 其他配置

服务器配置通过 cline_mcp_settings.json 文件进行管理。确保正确设置以下环境变量：

• N8N_HOST: 您的 n8n API 主机 URL。
• N8N_API_KEY: 您的 n8n API 密钥。

cline_mcp_settings.json 中的配置示例：

{
  "n8n-workflow-builder": {
    "command": "node",
    "args": ["/root/n8n-workflow-builder/build/index.js"],
    "env": {
      "N8N_HOST": "https://n8n.io/api/v1/",
      "N8N_API_KEY": "YOUR_N8N_API_KEY_HERE"
    },
    "disabled": false,
    "alwaysAllow": [
      "create_workflow",
      "create_workflow_and_activate",
      "update_workflow",
      "activate_workflow",
      "deactivate_workflow",
      "get_workflow",
      "delete_workflow"
    ],
    "autoApprove": []
  }
}

可用功能

MCP 工具

以下工具在服务器中定义，可以通过您的 MCP 客户端访问：

工作流管理

• list_workflows: 列出 n8n 中的所有工作流。
• create_workflow: 在 n8n 中创建一个新的工作流。
• get_workflow: 通过其 ID 检索一个工作流。
• update_workflow: 更新一个现有的工作流。
• delete_workflow: 通过其 ID 删除一个工作流。
• activate_workflow: 通过其 ID 激活一个工作流。
• deactivate_workflow: 通过其 ID 停用一个工作流。

执行管理

• list_executions: 列出所有工作流执行，并带有可选的过滤器。
• get_execution: 通过其 ID 检索特定执行的详细信息。
• delete_execution: 通过其 ID 删除一个执行。

MCP 资源

服务器还提供以下资源，以便更有效地访问上下文：

静态资源

• /workflows: n8n 实例中所有可用工作流的列表
• /execution-stats: 关于工作流执行的摘要统计信息

动态资源模板

• /workflows/{id}: 关于特定工作流的详细信息
• /executions/{id}: 关于特定执行的详细信息

故障排除

• 确保您正在使用 npm（此版本不支持 npx）。
• 如果您遇到任何问题，请尝试清理构建目录并重新构建：

  npm run clean && npm run build
  

• 验证 cline_mcp_settings.json 中的环境变量是否正确。

未来增强

• 重新引入 npx 支持。
• 额外的工具和工作流功能。
• 进一步增强部署和扩展。

许可证

本项目基于 MIT 许可证。