内容
align="center">
# MCP服务器 for n8n
**适用于 [n8n](https://n8n.io) 的最完整的MCP服务器**
43 种工具 · 工作流 · 数据表 · 标签 · 凭证 · 用户 · Webhooks · 审计
[](https://www.npmjs.com/package/@nextoolsolutions/mcp-n8n)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io/)
[快速开始](#-快速开始) · [所有43种工具](#-工具) · [配置](#%EF%B8%8F-配置) · [贡献](#-贡献)
</div>
---
## 为什么选择mcp-n8n？
其他n8n MCP仅涵盖工作流和执行。**mcp-n8n涵盖所有内容** — 包括数据表，这是唯一一个做到这一点的MCP。
| 功能 | mcp-n8n | leonardsellem | illuminare | czlonkowski |
|---|:---:|:---:|:---:|:---:|
| 工作流（CRUD + 执行 **10** | 7 | 4 |
| 执行 | **3** | 5 | 3 | 2 |
| **数据表** | **8** | — | — | — |
| 标签 + 工作流标签 | **7** | — | 5 | — |
| 凭证 | **4** | — | 3 | — |
| 用户 | **3** | — | 4 | — |
| 变量 | **3** | — | 3 | — |
| 项目（企业） | **4** | — | 4 | — |
| 安全审计 | **1** | — | 1 | — |
| Webhooks | **1** | 1 | — | 1 |
| 健康检查 | **1** | — | — | 1 |
| **总计** | **43** | **12** | **33** | **20** |
> **数据表** — 具有筛选、搜索、更新和 dry-run 的完整CRUD。其他MCP都不具备此功能。
---
## 🚀 快速开始
<details open>
<summary><strong>Claude 代码</strong></summary>
```bash
claude mcp add --scope user \
-e N8N_BASE_URL=http://localhost:5678 \
-e N8N_API_KEY=your-api-key \
-- n8n npx -y @nextoolsolutions/mcp-n8n
```
</details>
<details>
<summary><strong>Cursor</strong></summary>
将以下内容添加到 `~/.cursor/mcp.json`：
```json
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["-y", "mcp-n8n"],
"env": {
"N8N_BASE_URL": "http://localhost:5678",
"N8N_API_KEY": "your-api-key"
}
}
}
}
```
</details>
<details>
<summary><strong>Claude 桌面版</strong></summary>
将以下内容添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["-y", "mcp-n8n"],
"env": {
"N8N_BASE_URL": "http://localhost:5678",
"N8N_API_KEY": "your-api-key"
}
}
}
}
```
配置文件位置：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
</details>
<details>
<summary><strong>Windsurf</strong></summary>
将以下内容添加到 Windsurf MCP 配置中：
```json
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["-y", "mcp-n8n"],
"env": {
"N8N_BASE_URL": "http://localhost:5678",
"N8N_API_KEY": "your-api-key"
}
}
}
}
```
</details>
<details>
<summary><strong>VS Code (Copilot)</strong></summary>
将以下内容添加到 VS Code `settings.json` 中：
```json
{
"mcp": {
"servers": {
"n8n": {
"command": "npx",
"args": ["-y", "mcp-n8n"],
"env": {
"N8N_BASE_URLhttp://localhost:5678",
"N_API_KEYyour-api-key"
}
}
}
```
>
### 获取 API
1.8n 实例. 进入 **设置 → n8n API**
3. 创建一个新的 API 密钥
4. 将其复制到 `N8N_API_KEY` 环境变量中
---
## 🛠 工具
### 工作流（10）
| 工具 | 描述 |
|---|---|
| `n8n_list_workflows` | 列出所有工作流，可选筛选 |
| `n8n_get_workflow` | 通过ID获取工作流（包括节点、连接、设置） |
| `n8n_create_workflow` | 从JSON创建新的工作流 |
| `n8n_update_work | 更新现有（完全替换） `n8_workflow`永久删除工作流 `n8activate_workflow` | 激活工作流生产使用 |
n8n_workflow` |用工作流 `n8_workflow` |执行，可选 |
| `n8n_get_workflow_tags` | 列出与工作的标签 |
| `n_update_workflow_tags替换工作流标签 |
### 执行（3）
| 工具 ||---|---|
| `n_list_executions 列出执行记录，（工作流、状态、光标） |
|8n_get_execution`状态、结果数据 |
| `n8n_delete_execution` | 删除 |
### 数据表（
> 仅8n v1. 中可用。这是 **唯一表的MCP服务器**。
| 工具 | 描述---|---|
| `n_list_datatables` | 列出所有数据表，支持筛选和排序 |
|8n_create_datatable` | 创建具有类型化字符串、数字、布、日期、JSON）的数据表 |
| `n_get_datatable` |元数据（列、名称、ID） |
|8n_get_datatable | 查询行，、全文本搜索、排序和分页 |
| `n8_datatable_rows`插入一行或多行 `n8n_update_rows` | 更新的行（支持 dry-run| `n8n_upsert_datatable_row` | 更新如果存在，插入如果不存在 |
| `n8n_delete_datatable_rows` | 删除匹配筛选的行（支持 dry-run） |
### 标签（5）
| 工具 | 描述 |
|---|---|
| `n8n_list_tags` | 列出 |
| `n_get_tag 通过ID获取标签 |
|8n_create | 创建新标签 |
n8n_update_tag` | 重命名标签 |
n8n_delete_tag 删除标签 |
###（4）
| 描述 |
|| `n8n` | 列出凭证名称和类型 — 数据被删减） |
|8n_create_ | 创建凭证（首先使用 `get_credential_schema |
| `n8ncredential` | 删除| `n8n_get_credential_schema` | 获取凭证类型的JSON模式 |
（3）
| 工具 | 描述 |
|| `n8n_list_users` | 列出（需要实例所有者角色） |
| `n_get_user` | 通过电子邮件获取用户 |
| `n8n_delete_user` | 删除用户 |
### 变量（3）
| 工具 | 描述 |
|---|---|
| `n8n_list_variables` | 列出所有环境变量 |
| `n8n_create_variable`键值变量 |
| `n8n_delete_variable 删除变量 |
### 项目（4）— 企业
工具 | 描述 |
|---|---|
| `n8` | 列出所有项目 |
| `n_create_project` | 创建项目 |
| `n8n_update_project` | 重命名项目 |
| `n8` | 删除项目 |
### 审计（1| 工具 ||---|---|
| `n_generate_audit`安全审计（凭证、文件系统、节点 系统（1） 工具 | 描述---|---|
| `n_health_check` |8n API连接 Webhooks（1 工具 ||---|---|
| `n8n_trigger_webhook 通过其Webhook URL触发工作流（生产或测试---
## ⚙
| 变量 | | 描述 |
|---|---|---|
| `N8N_BASE_URL` | `http://localhost:5678` | 您的n8n实例URL |
| `N8N_API_KEY` | — | API密钥（**必填**） |
| `N8N_MAX_RETRIES` | `3` | 429 / 5xx错误重试次数 |
| `N8N_TIMEOUT` | `30000` | 请求超时毫秒数 |
---
## ✨ 功能
- **43 种工具** — 可用的最全面的n8n MCP
- **数据表** — 完整的CRUD，唯一支持此功能的MCP
- **自动重试** — 速率限制（429）和服务器错误（5xx）的指数退避
- **可配置超时** — 防止请求挂起（默认30秒）
- **零外部依赖** — 仅MCP SDK + Zod
- **TypeScript 严格模式** — 完全类型化、安全且可维护
- **兼容 Node 16+** — 原生fetch，支持http/https回退
---
## 🔒 安全
- API密钥 **从不硬编码** — 仅从环境变量加载
- 凭证数据在列表响应中被 **删减** （n8n API行为）
- 所有ID都使用`encodeURIComponent`进行清理，以防止路径遍历
- 没有敏感数据被记录或在错误消息中暴露
---
## 🏗 开发
```bash
git clone https://github.com/RPGMais/mcp-n8n.git
cd mcp-n8n
npm install
```
| 命令 | 描述 |
|---|---|
| `npm run dev` | 使用tsx运行（无需构建步骤） |
| `npm run build` | 编译TypeScript到`dist/` |
| `npm start` | 运行编译后的版本 |
### 项目结构
```
mcp-n8n/
├── src/
│ ├── index.ts # MCP服务器 — 工具注册和处理程序
│ └── n8n-client.ts # HTTP客户端 — API调用、重试、超时
├── dist/ # 编译输出
├── package.json
├── tsconfig.json
└── README.md
```
---
## 🤝 贡献
欢迎贡献！请：
1. 复刻仓库
2. 创建一个功能分支（`git checkout -b feat/my-feature`）
3. 提交更改
4. 推送并打开拉取请求
---
## 📄 许可证
[MIT](LICENSE) — 免费用于个人和商业用途。
---
<div align="center">
由 [NexTool Solutions](https://github.com/RPGMais) 构建
如果这个项目对您有帮助，请考虑给它一个 ⭐
</div>
