n8n MCP 服务器

一个模型上下文协议（MCP）服务器，允许 AI 助手通过自然语言与 n8n 工作流交互。

概述

此 MCP 服务器为 AI 助手提供了管理 n8n 工作流及其执行的工具和资源。它允许助手执行以下操作：

• 列出、创建、更新和删除工作流
• 启用和禁用工作流
• 执行工作流并监控其状态
• 访问工作流信息和执行统计信息

安装

先决条件

• Node.js 18 或更高版本
• 已启用 API 接访问的 n8n 实例

从 npm 安装

npm install -g n8n-mcp-server

从源代码安装

# 克隆仓库
git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

# 可选：全局安装
npm install -g .

配置

在运行服务器的目录中创建一个 .env 文件，使用 .env.example 作为模板：

cp .env.example .env

配置以下环境变量：

生成 n8n API 密钥

1. 在浏览器中打开您的 n8n 实例
2. 转到 设置 > API > API 密钥
3. 创建一个具有适当权限的新 API 密钥
4. 将密钥复制到您的 .env 文件中

使用方法

运行服务器

从安装目录：

n8n-mcp-server

或如果全局安装：

n8n-mcp-server

与 AI 助手集成

要将此 MCP 服务器与 AI 助手平台注册，具体方法取决于您使用的平台。例如，使用 MCP 安装程序：

npx @anaisbetts/mcp-installer

然后注册服务器：

install_local_mcp_server path/to/n8n-mcp-server

可用工具

服务器提供了以下工具：

工作流管理

• workflow_list：列出所有工作流
• workflow_get：获取特定工作流的详细信息
• workflow_create：创建新的工作流
• workflow_update：更新现有工作流
• workflow_delete：删除工作流
• workflow_activate：启用工作流
• workflow_deactivate：禁用工作流

执行管理

• execution_run：执行工作流
• execution_get：获取特定执行的详细信息
• execution_list：列出工作流的执行
• execution_stop：停止正在运行的执行

资源

服务器提供了以下资源：

• n8n://workflows/list：所有工作流的列表
• n8n://workflow/{id}：特定工作流的详细信息
• n8n://executions/{workflowId}：工作流的执行列表
• n8n://execution/{id}：特定执行的详细信息

开发

构建

npm run build

以开发模式运行

npm run dev

测试

npm test

格式检查

npm run lint

许可证

MIT