工作流管理服务器

Name: 工作流管理服务器
Author: nikolausm

作者：nikolausm3 星标更新：2025-06-16

安装使用来源：spider==github.com

项目介绍

n8n MCP Server

MCP（模型上下文协议）服务器用于n8n工作流自动化。此服务器使AI助手如Claude能够通过REST API与n8n实例进行交互。

功能

🔄 工作流管理：列出、创建、更新和删除工作流
▶️ 执行控制：执行工作流并监控执行情况
🏷️ 标签管理：使用标签组织工作流
📊 执行历史：访问工作流执行历史和结果
🔑 凭据管理：列出可用的凭据（只读）
🌐 Webhook管理：创建和管理webhook
🔍 搜索：按名称或标签搜索工作流

预备条件

Node.js 18或更高版本
具有API访问权限的n8n实例
n8n API密钥

安装

从npm安装（当已发布时）

npm install -g n8n-mcp-server

从源代码安装

git clone https://github.com/nikolausm/n8n-m-服务器.git
cd n8n-mcp-server
npm install
npm run build

配置

获取您的n8n API密钥

登录到您的n8n实例
前往设置 → API
生成一个API密钥

配置Claude桌面

在您的Claude桌面配置文件（claude_desktop_config.json）中添加以下内容：

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/path/to/n8n-mcp-server/dist/index.js"],
      "env": {
        "N8N_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

对于n8n云实例，请使用：

N8N_URL：https://your-subdomain.app.n8n.cloud

可用工具

工作流管理

list_workflows - 列出所有工作流，可选过滤
get_workflow - 获取特定工作流的详细信息
create_workflow - 从JSON创建新工作流
update_workflow - 更新现有工作流
delete_workflow - 删除工作流
activate_workflow - 激活工作流
deactivate_workflow - 禁用工作流

执行

execute_workflow - 执行工作流，可选输入数据
get_executions - 获取执行历史，可选过滤选项
get_execution - 获取特定执行的详细信息
delete_execution - 删除执行
retry_execution - 重试失败的执行

其他

get_credentials - 列出可用的凭据（仅名称）
search_workflows - 按名称或标签搜索工作流
get_workflow_webhooks - 获取工作流的webhook URL

使用示例

列出所有活动的工作流

助理：我将列出您所有的活动n8n工作流。

[使用list_workflows工具，active=true]

执行一个工作流

助理：我将根据您提供的数据执行该工作流。

[使用execute_workflow工具，workflowId和data]

创建一个新的工作流

助理：我将为您创建一个新的工作流。

[使用create_workflow工具，工作流JSON]

开发

设置

npm install

构建

npm run build

在本地测试

N8N_URL=https://your-instance.com N8N_API_KEY=your-key npm start

运行测试

npm test

安全注意事项

绝不要提交您的API密钥
对敏感数据使用环境变量
MCP服务器具有与您的API密钥相同的权限
如果可能，请考虑使用受限的API密钥

贡献

欢迎贡献！请：

分叉仓库
创建功能分支
进行更改
如适用，请添加测试
提交拉取请求