MCP n8n API 服务器

一个 mcp 服务器，提供通过模型上下文协议 (MCP) 与 n8n 工作流交互的接口。

特性

• 列出所有 n8n 工作流
• 使用自定义数据触发特定工作流
• 与 Claude Desktop 和其他 MCP 客户端集成

安装

全局安装（推荐用于远程使用）

npm install -g @ahmad.soliman/mcp-n8n-server

然后配置您的 n8n 连接：

1. 在您的工作目录中创建一个 .env 文件
2. 添加您的 n8n API 信息（请参阅下面的配置部分）

使用 npx（无需安装）

您可以直接使用 npx 运行服务器：

npx -y @ahmad.soliman/mcp-n8n-server

本地安装

git clone https://github.com/ahmadsoliman/mcp-n8n-server.git
cd mcp-n8n-server
npm install

配置

创建一个包含以下变量的 .env 文件：

# n8n 主机 URL（必需）
N8N_HOST_URL=https://your-n8n-instance.com

# n8n 项目 ID（可选 - 仅云实例需要）
PROJECT_ID=your_project_id_here

# n8n API 密钥（必需）
N8N_API_KEY=your_api_key_here

用法

作为远程 MCP 服务器

全局安装后，您可以将其用作 Claude AI 的远程 MCP 服务器：

1. 配置 Claude AI 以使用以下 JSON 配置将其用作远程 MCP 服务器：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@ahmad.soliman/mcp-n8n-server"],
      "env": {
        "N8N_HOST_URL": "",
        "PROJECT_ID": "",
        "N8N_API_KEY": ""
      }
    }
  }
}

2. 将以下内容添加到您的提示或 Claude 的指令中：

您有权访问用于 n8n 集成的远程 MCP 服务器。 使用它来：
- 列出所有 n8n 工作流
- 触发 Webhook 和工作流
- 获取有关可用 Webhook 的信息

作为本地 MCP 服务器

您可以在本地运行服务器并从 Claude Desktop 连接到它：

# 启动服务器
npm start

然后配置 Claude Desktop 以使用此 MCP 服务器：

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@ahmad.soliman/mcp-n8n-server"],
      "env": {
        "N8N_HOST_URL": "",
        "PROJECT_ID": "",
        "N8N_API_KEY": ""
      }
    }
  }
}

或者，如果您已在本地克隆了存储库：

{
  "mcpServers": {
    "n8n-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/server-n8n/build/index.js"]
    }
  }
}

设置

1. 安装依赖项：

npm install

2. 配置环境变量：

• 将 .env.example 复制到 .env（如果尚未完成）
• 更新 .env 中的以下变量：
  • N8N_API_URL: 您的 n8n 实例 URL（默认：http://localhost:5678）
  • N8N_API_KEY: 您的 n8n API 密钥

3. 启动服务器：

# 启动 MCP 服务器（用于与 Claude Desktop 和其他 MCP 客户端集成）
npm run mcp

用于开发并自动重新加载：

npm run dev

MCP 工具（用于 LLM 集成）

MCP 服务器公开以下工具，用于 Claude Desktop 或其他 MCP 客户端：

列出工作流

list-workflows 工具返回所有可用 n8n 工作流的列表。

列出工作流 Webhook

list-workflow-webhooks 工具返回来自特定工作流的所有 Webhook。

参数：

• id：要从中获取 Webhook 的工作流的 ID

调用 Webhook (GET)

call-webhook-get 工具允许使用 GET 请求调用 Webhook。

参数：

• url：要调用的 Webhook URL

调用 Webhook (POST)

call-webhook-post 工具允许使用 POST 请求调用 Webhook。

参数：

• url：要调用的 Webhook URL
• data：要在 POST 请求正文中发送的数据