n8n MCP Server

n8n MCP Server

site icon
2025.03.28 0
TypeScript工作流管理自动化开发效率
n8n MCP Server 是一个模型上下文协议(MCP)服务器,允许AI助手通过自然语言与n8n工作流进行交互。它提供了管理和执行n8n工作流的工具和资源,包括工作流的创建、更新、删除、激活、停用以及执行和监控。
View on GitHub

Overview

基本能力

产品定位

n8n MCP Server 是一个模型上下文协议(MCP)服务器,旨在通过自然语言使AI助手能够与n8n工作流进行交互和管理。

核心功能

  • 工作流管理:列出、创建、更新、删除工作流,激活和停用工作流。
  • 执行管理:执行工作流、监控执行状态、获取执行详情、停止执行。
  • 资源访问:提供工作流列表、工作流详情、执行列表和执行详情的资源访问。

适用场景

  • AI助手与n8n工作流的集成。
  • 自动化工作流的管理和执行。
  • 通过自然语言指令操作n8n工作流。

工具列表

工作流管理

  • workflow_list: 列出所有工作流。
  • workflow_get: 获取特定工作流的详情。
  • workflow_create: 创建新工作流。
  • workflow_update: 更新现有工作流。
  • workflow_delete: 删除工作流。
  • workflow_activate: 激活工作流。
  • workflow_deactivate: 停用工作流。

执行管理

  • execution_run: 执行工作流。
  • execution_get: 获取特定执行的详情。
  • execution_list: 列出工作流的执行。
  • execution_stop: 停止正在运行的执行。

常见问题解答

  • 如何生成n8n API密钥?
  • 在浏览器中打开n8n实例。
  • 转到设置 > API > API密钥。
  • 创建具有适当权限的新API密钥。
  • 将密钥复制到.env文件中。

使用教程

使用依赖

  • 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文件并配置以下环境变量: - N8N_API_URL: n8n API的URL。 - N8N_API_KEY: 用于n8n认证的API密钥。 - DEBUG: 启用调试日志(可选)。

运行服务器

n8n-mcp-server

调试方式

开发模式运行

npm run dev

测试

npm test

代码检查

npm run lint

许可证

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