Leonardsellem N8n MCP Server

🚀 n8n MCP 服务器

n8n MCP 服务器是一个模型上下文协议（MCP）服务器，它让 AI 助手能够通过自然语言与 n8n 工作流进行交互，为 AI 助手管理 n8n 工作流提供了便利。

🚀 快速开始

n8n MCP 服务器为 AI 助手提供了管理 n8n 工作流及其执行的工具和资源。借助该服务器，AI 助手可以进行一系列操作，如列出、创建、更新和删除工作流，启用和禁用工作流，执行工作流并监控其状态，以及访问工作流信息和执行统计信息。

✨ 主要特性

• 支持 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 许可证。