MCP工作流服务器
项目介绍
MCP n8n Server
为 Claude Desktop 和 Cursor 完整集成 n8n API - 通过 AI 对话管理流程，自动化任务，并控制 n8n 的各个方面。
使用自然语言命令转换您的 n8n 工作流管理。创建复杂的自动化，监控执行，管理凭据，并在不离开 IDE 的情况下编排整个 n8n 基础设施。
🎯 令牌优化
此服务器经过优化以最小化令牌消耗，解决了 MCP 服务器最大的问题之一：过度使用 API 令牌。
我们已优化的内容：
- 使用新的
n8n_list_workflows_summary端点，工作流列表的令牌消耗减少了 90% - 字段过滤 - 请求您需要的数据
- 智能默认值 - 查询结果从 100 减少到 10-20 条
- 智能警告 - 当操作将消耗大量令牌时发出警报
详情参见 TOKEN_OPTIMIZATION.md。
✨ 功能
🔄 工作流管理
- 创建与部署：使用自然语言描述构建工作流
- CRUD 操作：全生命周期管理（创建、读取、更新、删除）
- 激活控制：按需启用或禁用工作流
- 项目转移：无缝地在项目之间移动工作流
- 标签管理：使用自定义标签组织工作流
📊 执行监控
- 实时跟踪：使用高级过滤器监控工作流执行
- 详细洞察：访问完整的执行数据和日志
- 错误恢复：自动重试失败的执行
- 清理工具：高效管理执行历史
🔐 凭据管理
- 安全创建：添加任何服务的凭据
- 模式发现：自动发现凭据类型所需的字段
- 项目隔离：安全地在项目之间传输凭据
- 类型支持：兼容所有 n8n 凭据类型
🎯 工作流模板
- 预建解决方案：包括 100 个生产就绪的工作流模板
- 智能匹配：AI 自动选择最适合您用例的模板
- 类别：电子商务、社交媒体、AI/聊天、通信、内容、HR、销售/CRM、金融、数据抓取、监控、生产力
- 可定制：所有模板都是完全可定制的起点
🏗️ 组织与管理
- 标签：分类和组织资源
- 变量：集中管理环境变量
- 项目：多租户项目支持
- 用户与权限：完整的访问控制管理
- 审计日志：生成安全性和合规性报告
🚀 快速开始
通过 npm 安装（推荐）
这是最简单的入门方式：
npm install -g mcp-n8n
配置
-
获取您的 n8n API 凭据：
- 导航至您的 n8n 实例 → 设置 → n8n API
- 生成一个新的 API 密钥
-
配置 Claude Desktop：
在 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac/Linux）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）中添加：
选项 A - 使用全局安装（如果您运行了 npm install -g mcp-n8n）：
{
"mcpServers": {
"n8n": {
"command": "mcp-n8n",
"env": {
"N8N_BASE_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
选项 B - 使用 npx（无需安装，始终使用最新版本）：
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["-y", "mcp-n8n"],
"env": {
"N8N_BASE_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
- 配置 Cursor：
在 Cursor MCP 设置（设置 → 扩展 → MCP）中添加：
推荐 - 使用 npx（始终使用最新版本）：
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["-y", "mcp-n8n"],
"env": {
"N8N_BASE_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
注意：Cursor 需要使用
npx进行 MCP 服务器配置。-y标志会自动安装/更新包而不会提示。
- 重启 Claude Desktop 或 Cursor
💬 使用示例
配置完成后，可以使用自然语言与 n8n 交互：
创建工作流
"创建一个监控我的 Gmail 收件箱并在重要邮件时发送 Slack 通知的工作流"
"构建一个每日报告工作流，从我的数据库中提取数据，生成图表并将其发送给我的团队"
使用模板
"我需要一个用于客户支持的 WhatsApp 聊天机器人"
→ 自动创建来自“WhatsApp AI 响应机器人”模板的工作流
"创建一个自动股票分析工作流"
→ 使用“GPT-4 自动股票分析”模板
管理工作流
"显示生产项目中的所有活动工作流"
→ 使用 n8n_list_workflows_summary 以节省令牌
"显示工作流 abc123 的详细信息"
→ 使用 n8n_get_workflow 在需要时仅获取完整详细信息
"停用'Daily Backup'工作流"
"执行 abc123 出了什么问题？"
监控与调试
"显示最后 10 个失败的执行"
"重试工作流 xyz456 中的所有失败执行"
"删除超过 30 天的成功执行"
🛠️ 可用工具
<details> <summary><strong>工作流 (11 个工具)</strong></summary>n8n_create_workflow- 创建新工作流n8n_list_workflows_summary- ⚡ 节省令牌 列表（仅 id、名称、活动状态、标签）n8n_list_workflows- 列出带有完整详细信息和可选字段过滤n8n_get_workflow- 获取详细的工作流信息n8n_update_workflow- 修改现有工作流n8n_delete_workflow- 永久删除工作流n8n_activate_workflow- 启用工作流执行n8n_deactivate_workflow- 暂停工作流执行n8n_transfer_workflow- 在项目之间移动n8n_get_workflow_tags- 查看工作流标签n8n_update_workflow_tags- 修改工作流标签
n8n_list_workflow_templates- 浏览可用模板n8n_get_workflow_template- 查看模板详细信息n8n_create_workflow_from_template- 从模板创建
100 个模板，涵盖 13 个类别：
- 电子商务：Shopify 自动化、WooCommerce 支持代理
- 社交媒体：Instagram、TikTok、LinkedIn、Twitter 自动化
- AI/聊天：聊天机器人、AI 代理、语音助手
- 通信：WhatsApp、Telegram、电子邮件自动化
- 内容：博客自动化、视频生成、SEO 优化
- HR/招聘：简历筛选、候选人搜寻
- 销售/CRM：潜在客户生成、冷电话管道
- 金融：股票分析、发票提取
- 数据抓取：Google Maps、LinkedIn、Amazon、TikTok
- 监控：网站正常运行时间、竞争对手追踪
- 生产力：日历、Notion、调度自动化
n8n_list_executions- 按状态、工作流、项目过滤n8n_get_execution- 详细的执行数据n8n_delete_execution- 删除执行记录n8n_retry_execution- 重试失败的执行
n8n_create_credential- 添加新的凭据n8n_delete_credential- 删除凭据（仅限所有者）n8n_get_credential_schema- 发现所需字段n8n_transfer_credential- 在项目之间移动
标签：创建、列出、获取、更新、删除 变量：创建、列出、更新、删除 用户：列出、创建、获取、删除、更改角色 项目：创建、列出、更新、删除、管理用户
</details> <details> <summary><strong>高级 (2 个工具)</strong></summary>n8n_generate_audit- 安全审计报告n8n_pull_source_control- 版本控制集成
总计：41 个工具，用于全面管理 n8n
📚 文档
🏗️ 项目结构
mcp-n8n/
├── src/
│ ├── index.ts # MCP 服务器实现
│ ├── n8n-client.ts # n8n API 客户端
│ └── types.ts # TypeScript 定义
├── examples/
│ ├── templates-metadata.json
│ └── *.json # 预建的工作流模板
├── dist/ # 编译输出
├── QUICKSTART.md # 快速入门指南
├── EXAMPLES.md # 使用示例
├── NODE_REFERENCE.md # API 文档
└── package.json
🔧 开发
本地安装（用于开发）
如果您想贡献或测试本地更改：
1. 设置
# 克隆仓库
git clone https://github.com/gomakers-ai/mcp-n8n.git
cd mcp-n8n
# 安装依赖
npm install
# 构建
npm run build
# 开发时自动重建
npm run watch
2. 使用本地构建进行配置
对于 Claude Desktop，在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加：
{
"mcpServers": {
"n8n": {
"command": "node",
"args": ["/绝对路径/to/mcp-n8n/dist/index.js"],
"env": {
"N8N_BASE_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
对于 Cursor，在 MCP 设置中添加：
{
8nServers": {
"n8n": {
"command": "node",
"args": ["/绝对路径/to/mcp-n8n/dist/index.js"],
"env": {
"N8N_BASE_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
重要：将 /绝对路径/to/mcp-n8n/ 替换为您克隆的仓库的实际绝对路径（例如，/Users/yourname/projects/mcp-n8n/）。
3. 测试
# 设置环境变量
cp .env.example .env
# 编辑 .env 文件以包含您的凭据
# 构建并测试
npm run build
node dist/index.js
🔍 要求
- Node.js：18 或更高版本
- n8n 实例：自托管或 n8n Cloud（付费计划）
- n8n API 密钥：用于身份验证
- AI IDE：支持 MCP 的 Claude Desktop 或 Cursor
n8n 要求
- 自托管：完整 API 访问 ✅
- n8n Cloud：需要付费计划才能访问 API
- 版本：兼容 n8n v1.0.0+
🤝 贡献
欢迎贡献！请随时提交拉取请求。
- 分叉仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交您的更改 (
git commit -m '添加一些 AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开拉取请求
📝 许可证
本项目采用 MIT 许可证 - 详见 LICENSE 文件。
🙏 致谢
🔗 资源
⚠️ 重要注意事项
API 访问
- n8n Cloud 需要 付费计划 才能访问 API
- 自托管 n8n 在所有计划上都有 完整 API 访问
- 某些操作需要 所有者/管理员权限
安全
- 不要提交包含凭据的
.env文件 - 使用环境变量存储敏感数据
- API 密钥授予对您的 n8n 实例的完全访问权限
- 定期轮换 API 密钥以确保安全
速率限制
- 尊重 n8n API 的速率限制
- 对于大型结果集，请使用分页
- 实现错误处理以应对速率限制响应
🐛 故障排除
连接问题
问题："无法连接到 n8n API"
- 验证
N8N_BASE_URL是否正确且可访问 - 检查 API 密钥是否有效
- 确保 n8n 实例正在运行
权限错误
问题："权限不足"
- 某些操作需要所有者/管理员角色
- 验证您的用户具有适当的权限
- 检查项目级别的访问权限
模板问题
问题："未找到模板"
- 确保
examples/目录存在 - 验证
templates-metadata.json存在 - 检查模板文件引用是否正确
💡 提示与最佳实践
- 从模板开始：使用预建模板作为起点
- 使用标签：使用标签组织工作流以便轻松管理
- 监控执行：定期检查失败的执行
- 清理：删除旧的执行数据以节省空间
- 版本控制：使用 n8n 内置的版本控制功能
- 先测试：在生产环境中激活之前测试工作流
📧 支持
- 问题：GitHub 问题
- 讨论：GitHub 讨论
- n8n 社区：community.n8n.io
<div align="center">
由 GoMakers.ai 制作 ❤️
</div>