MCP n8n API Server

MCP n8n API 服务

一个 MCP 服务，可通过 Model Context Protocol (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 Host URL (required)
N8N_HOST_URL=https://your-n8n-instance.com

# n8n Project ID (optional - only needed for cloud instances)
PROJECT_ID=your_project_id_here

# n8n API Key (required)
N8N_API_KEY=your_api_key_here

使用

作为远程 MCP 服务

全局安装后，你可以将其作为远程 MCP 服务与 Claude AI 配合使用：

1. 使用以下 JSON 配置，将 Claude AI 配置为使用此远程 MCP 服务：

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

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

You have access to a remote MCP server for n8n integration. Use it to:
- List all n8n workflows
- Trigger webhooks and workflows
- Get information about available webhooks

作为本地 MCP 服务

你可以在本地运行此服务，并从 Claude Desktop 连接：

# Start the server
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. 启动服务：

# Start the MCP server (for integration with Claude Desktop and other MCP clients)
npm run mcp

如需在开发过程中自动重新加载：

npm run dev

MCP 工具（用于大模型集成）

此 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 请求正文中发送的数据