MCP N8n Tools

描述

mcp-n8n工具 是服务器 MCP（模型上下文协议） 允许公开实例 n8n自托管 MCP兼容客户端，包括 ChatGPT -通过接口 MCP HTTP.\ 它提供了一个完整的集成层，可以直接与N8N API交互：远程安全地查看、修改、执行和监控工作流。

有了这个网关，像ChatGPT这样的人工智能助手可以实时驱动N8N，触发工作流，分析执行，并协调复杂的自动化，无论是在本地还是通过Cloudflare隧道。

______________________________________________________________________

摘要

• 介绍
• 功能
• 建筑
• 先决条件
• 安装
• 配置
• 本地启动
• 与ChatGPT一起使用
• 项目结构
• 展示的MCP工具

______________________________________________________________________

介绍

mcp-n8n-tools 是一个MCP服务器，通过与模型上下文协议（MCP）兼容的JSON-RPC HTTP API公开N8n实例。

主要目标是使MCP客户端（如ChatGPT）能够：

• 列出和管理N8N工作流
• 启动执行
• 查看和管理执行

______________________________________________________________________

功能

• N8N工作流列表
• 按ID恢复工作流
• 创建简单的工作流
• 更新工作流
• 抑制工作流
• 使用Payload执行工作流
• 处决名单
• 恢复执行
• 停止执行

______________________________________________________________________

建筑

N8N侧：

• 实例自托管可访问sur：\

https://n8n.guzzler-bot.cloud

• API密钥身份验证N8N（X-N8N-API-KEY)

节点项目端：

• n8nClient.mjs ：HTTP客户端到N8N API
• server-http.mjs ：HTTP MCP服务器（JSON-RPC 2.0）公开MCP工具
• server.mjs + mcpServer.mjs ：基于官方SDK的STDIO MCP服务器（其他MCP客户端可选）

______________________________________________________________________

先决条件

• Node.js（建议使用18+版本）
• 访问N8n实例（例如： https://n8n.guzzler-bot.cloud)
• CléAPI n8n缬氨酸
• （可选）Cloudflare隧道向公众公开MCP服务器（例如，用于ChatGPT）

______________________________________________________________________

安装

克隆项目（或从Git获取）： git clone\mcp-n8n-tools cd mcp-n8n工具

安装依赖项： npm安装

配置 从.env.example在项目根目录（未提交）中创建.env文件： N8N_BASE_URL=https://n8n.guzzler-bot.cloud n8n-api-key=your-cle-api-n8n

提供了一个.env.example文件： N8N_BASE_URL=https://n8n.guzzler-bot.cloud N8N-API-KEY=替换为您的

环境变量通过dotenv加载到服务器文件中。

本地启动

1. 启动MCP HTTP服务器

在项目目录中： npm启动

默认情况下，server-http.mjs在以下位置启动JSON-RPC HTTP服务器： http://localhost:3333/mcp

您可以检查它是否使用简单的cURL（最小JSON-RPC示例）或通过MCP客户端进行响应。

1. 通过Cloudflare公开服务器（ChatGPT可选）

如果要将此服务器连接到ChatGPT，可以使用Cloudflare隧道： cloudflared隧道--urlhttp://localhost:3333

然后，Cloudflare提供以下类型的公共URL： https://xxxxxxxx.trycloudflare.com

MCP服务器将可在以下位置访问： https://xxxxxxxx.trycloudflare.com/mcp 注意：只要Cloudflared运行，此URL将保持活动状态。

与ChatGPT一起使用 启动MCP HTTP服务器： npm启动

Lancer le隧道Cloudflare： cloudflared隧道--urlhttp://localhost:3333

获取Cloudflare URL，例如： https://xxxxxxxx.trycloudflare.com/mcp

在ChatGPT（或任何其他MCP HTTP客户端）中： 添加新的MCP HTTP服务器 MCP服务器的URL：https://xxxxxxxx.trycloudflare.com/mcp

直接从ChatGPT使用MCP工具：

list_workflows get_workflow 创建工作流 update_workflow 删除工作流 运行工作流 列表执行 getexecution 停止执行

用于列出工作流的MCP/JSON-RPC调用示例：

{ “jsonrpc”：“2.0”， “id”：“1”， “方法”：“工具/调用”， “参数”：{ “tool”：“list_workflows”， “参数”：｛｝ } }

项目结构

mcp-n8n工具/ ├--n8nclient.mjs N8n API的通用HTTP客户端 ├── 服务器-http.mjs#服务器MCP http（JSON-RPC 2.0） --server.mjs服务器MCP stdio（可选） --mcpserver.mjs通过SDK实现MCP服务器 ├── package.json ├── .env.example#配置示例 Mabalin遇到了i-print学生。 └── README.md

展示的MCP工具

tools/list方法向MCP客户端公开以下工具：

list_workflows get_workflow 创建工作流 update_workflow 删除工作流 运行工作流 列表执行 getexecution 停止执行

每个工具都路由到n8nclient.mjs的函数：

list工作流 getWorkflowById 创建简单工作流 updateWorkflowById deleteWorkflowById 运行工作流 列表执行 getExecutionById stopExecutionById

⚠️ 此URL不公开任何未经身份验证的API。 所有操作都需要一个私有API密钥，该密钥不包括在此存储库中。