AI导哈

n8n工作流管理服务

本地MCP服务器，允许通过Claude Desktop管理n8n工作流，支持创建、更新、删除和激活/停用工作流。

  • by sergio2171
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 sergio2171/n8n-mcp-server

使用说明

n8n mcp服务器

📌 安装指南： https://github.com/sergio2171/n8n-mcp-server/blob/main/SETUP.md

该存储库包含本地MCP（模型上下文协议）服务器，允许Claude Desktop通过本地API管理n8n中的工作流。

本地MCP服务器（stdio），允许Claude Desktop通过HTTPS管理您的n8n工作流。

功能（MVP）-

  • 列出工作流
  • 获取工作流结构
  • 创建工作流
  • 更新工作流程
  • 删除工作流
  • 激活/停用工作流

下载

▶ 最新版本： https://github.com/sergio2171/n8n-mcp-server/releases

文件结构

n8n-mcp-server/
├── src/
│   ├── index.js
│   ├── n8nClient.js
│   ├── operations.js
│   ├── utils.js
│   └── validators.js
├── .env.example
├── package.json
├── README.md
└── CLAUDE_CONFIG.md

先决条件

  • 激活/停用工作f
  • Node.js 18+和npm
  • 访问n8n实例和API密钥
  • 已安装Claude Desktop

设置

  1. 克隆此存储库。
  2. 创建一个 .env 文件（或导出环境变量）使用 .env.example 作为模板：
cp .env.example .env
# edit N8N_API_URL and N8N_API_KEY
  1. 安装依赖项：
npm install
  1. 启动MCP服务器：
npm start

服务器在stdio上监听MCP客户端，如Claude Desktop。

Claude桌面配置

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/absolute/path/to/n8n-mcp-server"
    }
  }
}

可用操作

  • list_workflows（） –退货 id, name, active, createdAt, updatedAt 适用于所有工作流。
  • get_workflow（workflowId） –返回完整的工作流程JSON。
  • create_workflow（工作流数据） –创建工作流；节点ID丢失时生成。
  • update_workflow（工作流ID、工作流数据） –将部分数据与现有工作流合并，进行验证，然后进行修补。
  • delete_workflow（工作流ID） –删除工作流。
  • activate_workflow（工作流ID，活动） –切换激活状态。

使用示例

// Create a simple workflow
await tools.create_workflow({
  name: 'Test Workflow',
  nodes: [
    {
      name: 'Start',
      type: 'n8n-nodes-base.manualTrigger',
      typeVersion: 1,
      position: [250, 300],
      parameters: {}
    }
  ],
  connections: {},
  active: false
});

// Update part of a workflow
await tools.update_workflow('workflow-id', {
  name: 'Updated Name',
  active: true
});

错误处理

  • HTTP错误会显示状态代码和服务器消息。
  • 验证错误解释了哪个字段无效。
  • 对所有请求启用日志记录；集 LOG_LEVEL=debug 用于详细输出。

故障排除

  • 401未经授权：确认 N8N_API_KEY 是正确的。
  • HTTPS证书问题：确保您的系统信任n8n证书。
  • 无响应：验证 N8N_API_URL 以...结束 /api/v1/ 并且可以从运行MCP服务器的主机访问该实例。

相关 MCP