🚀 n8n MCP 服务器
n8n MCP 服务器是一个模型上下文协议（MCP）服务器，它允许 AI 助手借助自然语言与 n8n 工作流展开交互，为工作流管理提供了便捷途径。
🚀 快速开始
此 MCP 服务器为 AI 助手提供了管理 n8n 工作流及其执行的工具和资源。它使助手能够：
- 列出、创建、更新和删除工作流
- 启用和禁用工作流
- 执行工作流并监控其状态
- 访问工作流信息和执行统计
✨ 主要特性
- 支持 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 实例的 URL（例如http://localhost:3000）N8N_API_KEY: n8n 的 API 密钥
使用方法
💻 使用示例
基础用法
// 工作流管理
const result = await useWorkflowList();
// 返回所有工作流列表
const workflow = await useWorkflowGet('id');
// 获取特定工作流的详细信息
const new_workflow = {
name: 'New Workflow',
nodes: [],
edges: []
};
const result = await useWorkflowCreate(new_workflow);
// 创建新工作流
const updated_workflow = {
id: 'workflow-id',
name: 'Updated Workflow'
};
const result = await useWorkflowUpdate('workflow-id', updated_workflow);
// 更新现有工作流
await useWorkflowDelete('workflow-id');
// 删除工作流
// 执行管理
const data = {
input: 'Hello, World!'
};
const execution_result = await useExecutionRun('workflow-id', data);
// 通过 API 执行工作流
const webhook_result = await useRunWebhook('webhook-id', {
prompt: '触发网络钩子'
});
// 通过网络钩子执行工作流
await useExecutionStop('execution-id');
// 停止正在运行的执行
// 资源访问
const result = await getResource('n8n://workflows/list');
// 获取所有工作流列表
const workflow_details = await getResource(`n8n://workflow/${workflowId}`);
// 获取特定工作流的详细信息
const execution_list = await getResource(`n8n://executions/${workflowId}`);
// 获取工作流的所有执行
const execution_details = await getResource(`n8n://execution/${executionId}`);
// 获取特定执行的详细信息
开发
构建
npm run build
开发模式运行
npm run dev
测试
npm test
代码规范
npm run lint
📄 许可证
本项目采用 MIT 许可证。