# n8n-mcp

n8n-mcp 是一个 Model Context Protocol (MCP) 服务器，可让 Claude Desktop、Cursor、Windsurf 等 AI 助手完全访问 n8n 的 1,084+ 个节点、文档、模板和管理工具，从而能够自主构建、验证并部署生产级工作流。

Canonical URL: https://a2a-mcp.org/entry/n8n-mcp-zh

Language: zh

Category: MCP Servers

Updated: 2026-03-18

## 概述

n8n-mcp 是一个开源的 Model Context Protocol (MCP) 服务器，它在 AI 编码助手与 n8n 工作流自动化平台之间搭建了桥梁。它为 Claude Desktop、Claude Code、Cursor、Windsurf 和 VS Code 等工具提供了 n8n 完整生态系统的结构化、实时知识——包括 537 个核心节点 + 547 个社区节点（共 1,084 个）、2,709 个工作流模板，以及专为 AI 设计的验证逻辑。

该项目采用轻量级 Node.js 应用构建，内置 SQLite 数据库，响应时间低于 12ms，支持 stdio 和 HTTP 两种模式。只需连接一次，你的 AI 就能自主构建、验证、测试并部署完整的 n8n 工作流，无需复制粘贴或手动配置。

托管版本（含开箱即用的 Chat Agent）可在 [n8n-mcp.com](https://www.n8n-mcp.com) 使用（提供免费额度与付费计划），而 GitHub 仓库则完全支持 MIT 协议自托管。

## 核心特性

- **全面的节点知识库** —— 完整支持 1,084 个 n8n 节点，属性覆盖率 99%，操作覆盖率 63.6%，官方文档覆盖率 87%（新版本发布后 48 小时内更新）。
- **智能搜索与发现** —— 提供 `search_nodes`、`get_node`（多种详情模式）以及按来源（verified/community）过滤社区节点的功能。
- **真实世界示例** —— 从热门模板中预提取 2,646 个配置。
- **高级验证功能** —— `validate_node` 和 `validate_workflow`，支持 AI Agent 配置文件、运行时检查和依赖分析。兼容 n8n v2.17+ 的 AI Agent 工作流。
- **模板引擎** —— 支持搜索并获取 2,709+ 个开箱即用的工作流 JSON，并提供智能过滤。
- **n8n 管理工具**（可选 API 连接）—— 可直接在你的 n8n 实例中创建、更新、测试、执行和自动修复工作流。
- **性能与兼容性** —— 平均响应约 12ms，内存占用 70–120 MB，兼容任意 Node.js 版本。支持 stdio（Claude Desktop）和 HTTP/SSE 模式。
- **隐私与安全** —— 可选匿名遥测（可轻松禁用），无硬编码凭证，支持 webhook 安全模式。

## 安装与设置

### 快速开始（npx，无需安装）
```bash
npx n8n-mcp
```
然后在 Claude Desktop 的 `claude_desktop_config.json` 中添加配置，并设置 `MCP_MODE=stdio`。

### Docker（推荐用于生产环境）
```bash
docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest
```

### 云部署（一键部署）
通过仓库模板免费部署到 Railway。

### 本地完整构建
```bash
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start
```

可选环境变量：`N8N_API_URL`、`N8N_API_KEY`（用于直接管理工作流）、`LOG_LEVEL=error`、`MCP_MODE=stdio`。

## 支持的 AI 助手

- Claude Desktop / Claude Code
- Cursor
- Windsurf
- VS Code + Codex
- Antigravity
- 任何兼容 MCP 的客户端（托管服务支持 20+ 工具）

## 使用场景

- **AI 驱动的工作流创建** —— 描述“监控 Twitter 提及并将带情感分析的摘要发送到 Slack” → AI 自动生成、验证并部署完整 JSON。
- **现有工作流维护** —— AI 读取在线工作流，提出优化建议并应用针对性更新。
- **模板探索** —— 询问“使用社区节点的最佳 CRM 同步模板”，即可获得可直接导入的 JSON。
- **企业级自动化** —— 连接自托管 n8n 实例，实现大规模、安全、可审计的工作流生成。
- **学习与原型开发** —— 使用验证工具在投入生产前教会 AI 最佳实践。

## n8n 内置 MCP 与 n8n-mcp 的区别

n8n 原生 MCP 服务器（近期版本已提供）将你自己的工作流暴露为工具。而 n8n-mcp 是一个**互补的外部** MCP 服务器，专注于 **n8n 节点知识** 和 AI 辅助创作。两者结合使用可发挥最大威力：原生服务器用于触发工作流，n8n-mcp 用于智能工作流构建。

## 链接与资源

- GitHub: [czlonkowski/n8n-mcp](https://github.com/czlonkowski/n8n-mcp)
- 托管 Chat Agent 与仪表盘: [n8n-mcp.com](https://www.n8n-mcp.com)
- 免费额度：托管版每天 100 次工具调用，或自托管无限使用
- 文档与示例均在仓库中

n8n-mcp 能瞬间将任何 AI 编码助手转变为全栈 n8n 工作流专家。

## Tags

- mcp-server
- n8n
- ai-assistant
- workflow-automation
- claude-desktop
- cursor
- typescript
- node-js
- mcp
- automation

## Sources

- [Project website](https://github.com/czlonkowski/n8n-mcp)