MCP 服务器

n8n API MCP Server

用于与 n8n 实例交互的 MCP 服务器

jasondsmith72

开发者工具

访问服务器

README

n8n API MCP 服务器

一个用于与自托管 n8n 实例交互的模型上下文协议 (MCP) 服务器。

此服务器提供以下工具：

执行对 n8n API 的调用。
使用从 OpenAPI 规范填充的本地数据库搜索 n8n API 端点。
使用“快速记忆”数据库存储和检索常用的或成功的 API 调用，以便更快地进行自然语言访问。

功能

数据库

API 规范数据库 (api_spec.db): 存储有关 n8n API 端点的详细信息，从 OpenAPI/Swagger JSON 文件加载。供搜索和详细信息工具使用。
快速记忆数据库 (fast_memory.db): 缓存与自然语言查询关联的成功 API 调用。允许快速检索以前使用的调用，并建议保存新的成功调用。

工具

search_api_endpoints: 在本地 API 规范数据库中搜索与查询匹配的端点（路径、摘要、描述、标签）。
get_api_endpoint_details: 从本地 API 规范数据库中检索特定端点（路径和方法）的详细信息（参数、请求正文、响应）。
execute_api_call: 执行对配置的 n8n 实例的 API 调用。首先检查快速记忆；如果未找到，则提示在成功后将调用保存到快速记忆。
natural_language_api_search: 使用自然语言搜索 API 调用。首先检查快速记忆，然后根据查询回退到搜索 API 规范数据库。
save_to_fast_memory: 手动保存 API 调用（路径、方法、参数、数据）及其原始自然语言查询和描述到快速记忆数据库。
list_fast_memory: 列出当前存储在快速记忆数据库中的条目，可以选择按搜索词进行过滤。
delete_from_fast_memory: 按 ID 从快速记忆数据库中删除特定条目。
clear_fast_memory: 从快速记忆数据库中删除所有条目。
load_api_spec_from_json: 通过解析 OpenAPI/Swagger JSON 文件来加载或更新 API 规范数据库 (api_spec.db)。
send_raw_api_request: 使用原始请求字符串（例如，“GET /workflows?limit=5”）执行 API 调用。使用与 execute_api_call 相同的底层逻辑，包括快速记忆检查和保存提示。

设置

克隆存储库：

git clone https://github.com/jasondsmith72/N8N-api-MCP.git
cd N8N-api-MCP

安装依赖项：
```
npm install
```
构建服务器：
```
npm run build
```
这会将 TypeScript 代码编译为 build 目录中的 JavaScript。

配置

此服务器需要环境变量才能连接到您的 n8n 实例。这些通常在您的 MCP 客户端的配置文件（例如，cline_mcp_settings.json）中设置。

N8N_URL: 您的 n8n 实例的基本 URL（例如，http://your-n8n.example.com）。如果未设置，则默认为 http://localhost:5678。
N8N_API_KEY: 用于身份验证的 n8n API 密钥。

加载 API 规范

在使用搜索工具（search_api_endpoints、natural_language_api_search）之前，您需要填充 API 规范数据库。

获取您的 n8n 版本的 OpenAPI (Swagger) JSON 规范文件。这可能可以从 n8n 文档中获得，或者可以从您的实例下载（例如，/api/v1/docs-json）。
使用 load_api_spec_from_json 工具，提供下载的 JSON 文件的绝对路径：
```
load_api_spec_from_json(json_file_path="C:\\path\\to\\your\\n8n-openapi.json")
```

为 Cline / Claude Desktop 安装

将以下配置添加到您的 cline_mcp_settings.json（根据您的克隆位置调整 index.js 的路径）：

{
  "mcpServers": {
    "... other servers ...": {},
    "n8n-api-mcp": {
      "command": "node",
      "args": [
        "C:\\MCP-Servers\\N8N-api-MCP\\build\\index.js" // <-- 如果需要，更新此路径
      ],
      "env": {
        "N8N_URL": "YOUR_N8N_INSTANCE_URL", // 例如，"http://192.168.1.100:5678"
        "N8N_API_KEY": "YOUR_N8N_API_KEY_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}