n8n MCP Server

基本能力

产品定位

n8n MCP Server 是一个连接 AI 助手与 n8n 工作流的中间件，旨在通过自然语言简化工作流的管理和执行。

核心功能

• 工作流管理：包括列出、创建、更新、删除、激活和停用工作流。
• 执行管理：支持通过 API 或 Webhook 执行工作流，监控执行状态，获取执行详情和统计数据。
• 资源访问：提供对工作流列表、工作流详情、执行列表和执行详情的访问。

适用场景

• 自动化流程管理：通过 AI 助手快速管理和执行 n8n 工作流。
• 集成开发：在开发环境中集成 n8n 工作流，提高开发效率。
• 自动化测试：利用 AI 助手自动化测试工作流的执行和结果验证。

工具列表

• workflow_list：列出所有工作流。
• workflow_get：获取特定工作流的详情。
• workflow_create：创建新工作流。
• workflow_update：更新现有工作流。
• workflow_delete：删除工作流。
• workflow_activate：激活工作流。
• workflow_deactivate：停用工作流。
• execution_run：通过 API 执行工作流。
• run_webhook：通过 Webhook 执行工作流。
• execution_get：获取特定执行的详情。
• execution_list：列出工作流的执行。
• execution_stop：停止正在运行的执行。

常见问题解答

• 如何生成 n8n API Key：在 n8n 实例的设置中，进入 API > API Keys，创建并复制 API Key。
• 如何配置 Webhook：在 n8n 中创建 Webhook 触发的工作流，并设置 Basic Authentication。
• 如何调试：启用 DEBUG 环境变量以查看详细日志。

使用教程

使用依赖

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

安装教程

从 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 文件并配置以下环境变量：

cp .env.example .env

运行服务器

n8n-mcp-server

调试方式

启用 DEBUG 环境变量以查看详细日志：

export DEBUG=true
n8n-mcp-server

许可证

该项目遵循 MIT 开源许可条款。