AI导哈

n8n MCP服务器

一个连接AI助手到n8n工作流自动化实例的模型上下文协议（MCP）服务器，用于通过自然语言管理、执行和监控n8n工作流。

  • by harbouli
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 harbouli/n8n-mcp-server

使用说明

n8n MCP服务器

A. 模型上下文协议（MCP） 将AI助手（Claude、Cursor等）连接到您的 n8n 工作流自动化实例。通过自然语言管理、执行和监控n8n工作流。

特性

  • 工作流管理 --列出、创建、更新、删除、激活和停用工作流
  • 工作流执行 -通过REST API或通过webhook触发器直接运行工作流
  • 执行历史 --查看、检查和管理过去的工作流执行
  • 标签和诊断 --列出标签并检查n8n连接
  • 类型安全 --完全用TypeScript编写，具有适当的错误处理功能

先决条件

  • Node.js 18+（建议20+）
  • 跑步 n8n 实例（自托管或云）
  • 一 n8n API密钥 --在n8n下生成一个 设置→ API → 创建API密钥

快速开始

1.安装依赖项

npm install

2.配置

复制示例env文件并填写您的值：

cp .env.example .env

编辑 .env:

N8N_BASE_URL=http://localhost:5678
N8N_API_KEY=your-api-key-here

3.建造

npm run build

4.配置您的MCP客户端

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/n8n-mcp-server/build/index.js"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

光标(.cursor/mcp.json)

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/n8n-mcp-server/build/index.js"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

工具 说明
list_workflows 列出所有带有可选活动/标记过滤器的工作流
get_workflow 获取工作流的完整详细信息（节点、连接、设置）
create_workflow 使用名称、节点和连接创建新工作流
update_workflow 更新现有工作流
delete_workflow 永久删除工作流
activate_workflow 激活工作流，使其对触发器做出响应
deactivate_workflow 停用工作流
execute_workflow 通过REST API直接运行工作流
execute_workflow_via_webhook 通过其webhook URL触发工作流
list_executions 列出带有状态/工作流过滤器的执行历史记录
get_execution 获取完整的执行详细信息，包括运行数据
delete_execution 从历史记录中删除执行
list_tags 列出所有可用标签
health_check 验证与n8n实例的连接

用法示例

连接后，您可以向您的AI助手询问以下问题：

  • “列出我所有活动的n8n工作流”
  • “显示工作流42的详细信息”
  • “使用计划触发器和HTTP请求节点创建名为“每日报告”的新工作流”
  • 使用以下输入数据执行工作流15：｛“email”：test@example.com" }"
  • “显示最近10次失败的执行”
  • “激活工作流7”
  • “检查我的n8n实例是否可访问”

发展

# Run in development mode (no build needed)
npm run dev

# Build for production
npm run build

# Start production build
npm start

建筑

n8n-mcp-server/
├── src/
│   ├── index.ts         # MCP server entry point & tool definitions
│   └── n8n-client.ts    # n8n REST API client
├── build/               # Compiled output (generated)
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

工作流执行注意事项

n8n 公共API（v1） 不包括直接的“执行工作流”端点。此服务器提供两种方法：

  1. execute_workflow --使用内部 /rest/workflows/{id}/run 终点。适用于自托管实例。根据您的n8n设置，可能需要额外的身份验证配置。

  2. execute_workflow_via_webhook --调用工作流的webhook触发器URL。这是官方推荐的方法。您的工作流必须具有 网络钩子 节点作为触发器，必须 活跃的.

生成n8n API密钥

  1. 打开n8n实例
  2. 首选 设置 （左下齿轮图标）
  3. 点击 API
  4. 点击 创建API密钥
  5. 复制密钥并将其添加到您的 .env 或MCP客户端配置

许可证

麻省理工学院

相关 MCP