使用说明

项目简介

n8n Workflow Builder MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务。它旨在为大型语言模型(LLM)客户端提供一个标准化的接口,以便通过程序化的方式创建和管理 n8n 工作流。n8n 是一个流行的开源工作流自动化平台,而此 MCP 服务器则充当 LLM 与 n8n 之间的桥梁,使得 LLM 能够更方便地控制和利用 n8n 的自动化能力。

主要功能点

  • 程序化工作流创建: 允许客户端通过 MCP 协议,以 JSON 格式定义工作流的节点和连接,从而自动化 n8n 工作流的构建过程。
  • 工作流规范验证: 在创建工作流前,服务器会对客户端提供的规范进行验证,确保工作流定义的有效性。
  • 工作流配置导出: 成功创建工作流后,服务器会将完整的工作流配置以 JSON 格式返回给客户端,方便后续使用或集成。
  • 基于 MCP 的 REST API 接口: 通过 MCP 协议提供标准的 REST API 接口,方便 LLM 客户端进行交互。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/Jimmy974/n8n-workflow-builder.git
    cd n8n-workflow-builder
  2. 安装依赖:

    npm install
  3. 编译 TypeScript 代码:

    npm run build # 或者使用 'npx tsc'
  4. 启动服务器:

    npm start

服务器配置

要让 MCP 客户端连接到此服务器,您需要在客户端配置中添加以下服务器信息。这告诉 MCP 客户端如何启动和连接到 n8n Workflow Builder MCP Server。

{
  "n8n-workflow-builder": {
    "command": "node",
    "args": ["/path/to/n8n-workflow-builder/dist/index.js"]
  }
}

注意: 请将 '/path/to/n8n-workflow-builder' 替换为您实际克隆仓库后 'n8n-workflow-builder' 目录在您系统中的绝对路径。

基本使用方法

服务器启动后,MCP 客户端可以通过调用 'create_workflow' 工具来创建 n8n 工作流。客户端需要向服务器发送符合 MCP 协议的 JSON-RPC 请求,并在请求中包含工作流的定义,例如:

{
  "nodes": [
    {
      "type": "n8n-nodes-base.httpRequest",
      "name": "Example HTTP Request",
      "parameters": {
        "url": "https://example.com",
        "method": "GET"
      }
    }
  ],
  "connections": []
}

服务器将处理请求,创建相应的工作流,并返回工作流的 JSON 配置作为响应。客户端可以根据返回的配置在 n8n 中使用或进一步处理该工作流。

信息

分类

开发者工具