基本能力
产品定位
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 安装
bash
npm install -g n8n-mcp-server
从源码安装
bash
git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server
npm install
npm run build
npm install -g .
配置
创建 .env
文件并配置以下环境变量:
bash
cp .env.example .env
运行服务器
bash
n8n-mcp-server
调试方式
启用 DEBUG
环境变量以查看详细日志:
bash
export DEBUG=true
n8n-mcp-server