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_URL	n8n API 的 URL	http://localhost:5678/api/v1
N8N_API_KEY	用于与 n8n 验证的 API 密钥	n8n_api_...
DEBUG	启用调试日志记录（可选）	true 或 false

生成 n8n API 密钥

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

用法

运行服务器

从安装目录：

n8n-mcp-server

或者如果全局安装：

n8n-mcp-server

与 AI 助手集成

要将此 MCP 服务器与 AI 助手一起使用，您需要将其注册到您的 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