MCP 服务器

n8n MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它使 AI 助手能够通过自然语言与 n8n 工作流进行交互，支持诸如列出、创建、更新、执行和监控工作流等操作。

README

n8n MCP 服务器

一个模型上下文协议 (MCP) 服务器，允许 AI 助手通过自然语言与 n8n 工作流进行交互。

概述

此 MCP 服务器为 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 API 的完整 URL，包括 `/api/v1`	`http://localhost:5678/api/v1`
`N8N_API_KEY`	用于向 n8n 验证身份的 API 密钥	`n8n_api_...`
`N8N_WEBHOOK_USERNAME`	Webhook 身份验证的用户名（如果使用 Webhook）	`username`
`N8N_WEBHOOK_PASSWORD`	Webhook 身份验证的密码	`password`
`DEBUG`	启用调试日志记录（可选）	`true` 或 `false`

生成 n8n API 密钥

在浏览器中打开您的 n8n 实例
转到设置 > API > API 密钥
创建具有适当权限的新 API 密钥
将密钥复制到您的 .env 文件

用法

运行服务器

从安装目录：

n8n-mcp-server

或者如果全局安装：

n8n-mcp-server

与 AI 助手集成

构建服务器 (npm run build) 后，您需要配置您的 AI 助手（例如带有 Claude 扩展的 VS Code 或 Claude Desktop 应用程序）来运行它。这通常涉及编辑 JSON 配置文件。

示例配置（例如，在 VS Code settings.json 或 Claude Desktop claude_desktop_config.json 中）：

{
  "mcpServers": {
    // 为您的服务器指定一个唯一的名称
    "n8n-local": {
      // 使用 'node' 执行构建的 JavaScript 文件
      "command": "node",
      // 提供构建的 index.js 文件的 *绝对路径*
      "args": [
        "/path/to/your/cloned/n8n-mcp-server/build/index.js"
        // 在 Windows 上，使用双反斜杠：
        // "C:\\path\\to\\your\\cloned\\n8n-mcp-server\\build\\index.js"
      ],
      // 服务器需要的环境变量
      "env": {
        "N8N_API_URL": "http://your-n8n-instance:5678/api/v1", // 替换为您的 n8n URL
        "N8N_API_KEY": "YOUR_N8N_API_KEY", // 替换为您的密钥
        // 仅当您计划使用 webhook 工具时才添加 webhook 凭据
        // "N8N_WEBHOOK_USERNAME": "your_webhook_user",
        // "N8N_WEBHOOK_PASSWORD": "your_webhook_password"
      },
      // 确保服务器已启用
      "disabled": false,
      // 默认 autoApprove 设置
      "autoApprove": []
    }
    // ... 其他服务器可能在此处配置
  }
}

要点：

将 /path/to/your/cloned/n8n-mcp-server/ 替换为您克隆和构建存储库的实际绝对路径。
为您的操作系统使用正确的路径分隔符（macOS/Linux 使用正斜杠 /，Windows 使用双反斜杠 \\）。
确保您提供正确的 N8N_API_URL（包括 /api/v1）和 N8N_API_KEY。
服务器需要在助手可以运行 build/index.js 文件之前构建 (npm run build)。

可用工具

服务器提供以下工具：

使用 Webhook

此 MCP 服务器支持通过 n8n Webhook 执行工作流。要使用此功能：

在 n8n 中创建一个 Webhook 触发的工作流。
在您的 Webhook 节点上设置基本身份验证。
使用 run_webhook 工具触发工作流，仅传递工作流名称。

示例：

const result = await useRunWebhook({
  workflowName: "hello-world", // 将调用 <n8n-url>/webhook/hello-world
  data: {
    prompt: "Hello from AI assistant!"
  }
});

Webhook 身份验证使用 N8N_WEBHOOK_USERNAME 和 N8N_WEBHOOK_PASSWORD 环境变量自动处理。