n8n 工作流生成器 MCP 服务器

该项目提供了一个用于管理 n8n 工作流的 MCP 服务器。它通过一组定义的工具提供了列出、创建、更新、删除、激活和停用工作流的功能。

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

要求

• Node.js（建议使用 v14+）

• npm

Related MCP server: n8n MCP Server

详尽的安装指南

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 许可。