快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

npx @kernel.salacoste/n8n-workflow-builder --version

详细介绍

n8n工作流生成器MCP服务器

通过自然语言实现人工智能驱动的工作流自动化

使用以下工具构建、管理和监视n8n工作流 克劳德·艾 和 光标IDE 通过 模型上下文协议

![Documentation](https://salacoste.github.io/mcp-n8n-workflow-builder/) ](https://www.npmjs.com/package/@kernel.salacoste/n8n-workflow-builder) ](https://www.npmjs.com/package/@kernel.salacoste/n8n-workflow-builder) ![License: MIT](https://opensource.org/licenses/MIT)

AI-Powered Workflow Builder - Build n8n workflows with natural language

______________________________________________________________________

🎯 这是什么？

n8n工作流生成器MCP服务器 通过使您能够通过以下方式创建和管理n8n工作流，从而改变工作流自动化 对话式人工智能不再需要手动JSON编辑或复杂的UI导航——只需用自然语言描述你需要什么，让人工智能为你构建。

它解决的问题

❌ 手动工作流构建 耗时且容易出错
❌ 复杂的JSON编辑 需要深厚的技术知识
❌ 在IDE和n8n UI之间切换 打断你的开发流程
❌ 管理多个n8n环境 （开发、暂存、生产）很乏味

解决方案

✅ 以对话方式构建工作流程 使用Claude AI或Cursor IDE
✅ 自然语言接口 -用简明的英语描述工作流程
✅ 多实例支持 -从一个地方管理开发、暂存和生产
✅ 17个强大的工具 -完整的工作流生命周期管理
✅ 留在IDE中 -不需要上下文切换

______________________________________________________________________

✨ 主要特点

🤖 人工智能驱动的工作流创建

通过简单描述您的需求来创建复杂的n8n工作流。Claude AI和Cursor IDE理解您的意图，并生成生产就绪的工作流程。

🌍 多实例管理

通过智能实例路由，从单个MCP服务器无缝管理多个n8n环境（生产、测试、开发）。

🛠️ 17综合工具

完整的工作流生命周期覆盖：

8工作流工具 -创建、更新、删除、激活、执行
4执行工具 -监视、重试、分析运行
5标签工具 -组织和分类工作流
6凭证工具 （Epic 2）-安全的凭据管理

💬 自然语言接口

不需要JSON编辑。构建这样的工作流：

“创建一个webhook工作流，用于验证客户电子邮件、发送Slack通知并将数据存储在PostgreSQL中”

🔒 设计安全

内置凭证保护
API密钥加密
安全的多实例配置
从不暴露日志中的敏感数据

📚 综合文档

38+文件页 有指南和教程
交互式示例 以及工作流模式
故障排除指南 和常见问题
API 参考 具有完整的工具文档

______________________________________________________________________

🚀 快速开始

先决条件

Node.js v14+（建议使用v18+）
npm v7+
n8n实例 API访问（使用n8n v1.82.3+进行测试）
克劳德桌面版 或 光标IDE

安装

# Install globally via npm
npm install -g @kernel.salacoste/n8n-workflow-builder

# Verify installation
npx @kernel.salacoste/n8n-workflow-builder --version

配置

选项1：多实例（推荐）

创建 .config.json 在项目根目录中：

{
  "environments": {
    "production": {
      "n8n_host": "https://n8n.example.com",
      "n8n_api_key": "your_production_api_key"
    },
    "staging": {
      "n8n_host": "https://staging.n8n.example.com",
      "n8n_api_key": "your_staging_api_key"
    },
    "development": {
      "n8n_host": "http://localhost:5678",
      "n8n_api_key": "your_dev_api_key"
    }
  },
  "defaultEnv": "development"
}

选项2：单实例（向后兼容）

创建 .env 文件：

N8N_HOST=https://your-n8n-instance.com
N8N_API_KEY=your_api_key

Claude桌面集成

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@kernel.salacoste/n8n-workflow-builder"]
    }
  }
}

重新启动克劳德桌面 你准备好了！ 🎉

游标IDE集成

添加 .cursor/mcp.json 在您的工作空间中：

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@kernel.salacoste/n8n-workflow-builder"]
    }
  }
}

______________________________________________________________________

📖 完整的文件

浏览我们的综合文档网站：

🌐 全部文件

快速链接

第节	说明
🚀 快速入门教程	在5分钟内构建您的第一个工作流程
📦 安装指南	详细的设置说明
🔧 配置	多实例和环境设置
🛠️ api参考	完整的工具文档
🏗️ 多实例设置	管理多个n8n环境
💡 使用模式	最佳实践和对话模式
🐛 故障排除	常见问题和解决方案

______________________________________________________________________

🎨 例子

示例1：创建Webhook工作流

你：

在暂存中创建一个webhook工作流，该工作流： - 在/客户注册时接收POST请求 - 验证电子邮件和姓名字段 - 通过Gmail发送欢迎电子邮件 - 在PostgreSQL中存储客户

克劳德： ✅ 创建包含验证、电子邮件和数据库节点的完整工作流

示例2：多实例工作流管理

你：

列出过去7天内未运行的生产中的所有活动工作流

克劳德： 📊 分析生产环境并识别过时的工作流

示例3：调试失败的执行

你：

在生产中调试工作流456-它一直失败，出现错误

克劳德： 🔍 检索执行历史记录，确定根本原因，并提出修复建议

示例4：凭证管理

你：

显示OAuth2凭据的架构，然后帮助我创建Google Sheets API的凭据

克劳德： 🔐 检索凭据架构并指导您完成安全凭据创建

______________________________________________________________________

🛠️ MCP工具参考

工作流管理（8个工具）

工具	描述	用例示例
`list_workflows`	列出所有具有筛选功能的工作流	“显示生产中的活动工作流”
`get_workflow`	检索完整的工作流详细信息	“从暂存中获取工作流123”
`create_workflow`	从头开始构建新的工作流	“创建每日报告工作流”
`update_workflow`	修改现有工作流	“向工作流456添加错误处理”
`delete_workflow`	删除工作流	“删除工作流789”
`activate_workflow`	启用工作流执行	“激活工作流123”
`deactivate_workflow`	禁用工作流执行	“停用工作流456”
`execute_workflow`	手动触发工作流运行	“使用测试数据执行工作流789”

执行管理（4个工具）

工具	描述	用例示例
`list_executions`	使用筛选器查看执行历史记录	“显示从今天开始的失败执行”
`get_execution`	详细执行信息	“获取执行9876详细信息”
`delete_execution`	删除执行记录	“删除旧的测试执行”
`retry_execution`	重试失败的工作流运行	“重试执行9876”

标签管理（5个工具）

工具	描述	用例示例
`list_tags` / `get_tags`	检索所有工作流标签	“显示所有工作流标签”
`get_tag`	获取特定标签信息	“获取‘电子邮件自动化’的标签详细信息”
`create_tag`	创建工作流组织标签	“创建标签‘客户工作流’”
`update_tag`	修改标记信息	“将标记重命名为‘旧工作流’”
`delete_tag`	删除工作流标记	“删除标记‘弃用’”

凭证管理（6个工具-Epic 2）

工具	描述	用例示例
`get_credential_schema`	获取凭据类型JSON架构	“显示httpBasicAuth的架构”
`list_credentials`	安全指南（被n8n API阻止）	“列出凭据指南”
`get_credential`	安全指南（被n8n API阻止）	“获取凭证指南”
`create_credential`	使用模式验证创建凭据	“创建Gmail OAuth2凭据”
`update_credential`	不变性指南（DELETE+CREATE）	“更新凭据指南”
`delete_credential`	永久删除凭据	“删除凭据123”

______________________________________________________________________

🏗️ 多实例架构

使用智能路由管理多个n8n环境：

┌─────────────────────────────────────┐
│   MCP Server (Single Instance)     │
├─────────────────────────────────────┤
│                                     │
│  ┌──────────┐  ┌──────────┐       │
│  │ ConfigLoader│ EnvironmentMgr   │
│  └──────────┘  └──────────┘       │
│         │            │             │
│         ▼            ▼             │
│  ┌─────────────────────────┐      │
│  │   Instance Routing      │      │
│  └─────────────────────────┘      │
│         │                          │
└─────────┼──────────────────────────┘
          │
    ┌─────┴─────┬─────────────┬──────────────┐
    │           │             │              │
    ▼           ▼             ▼              ▼
┌────────┐  ┌────────┐   ┌────────┐    ┌────────┐
│  Dev   │  │Staging │   │  Prod  │    │Custom  │
│ n8n    │  │  n8n   │   │  n8n   │    │  n8n   │
└────────┘  └────────┘   └────────┘    └────────┘

优点：

✅ 单个MCP服务器管理所有环境
✅ 基于上下文的自动实例路由
✅ 每个环境单独的API密钥
✅ 对话中轻松切换环境

______________________________________________________________________

🎯 用例

🚀 开发工作流程

内置开发： 在本地创建和测试工作流
部署到暂存： 在QA环境中验证
推广到生产： 满怀信心地部署

📊 运营与监控

监控跨环境的执行状态
调试失败的工作流并进行详细分析
跟踪工作流性能和可靠性

🔄 工作流迁移

从一个实例导出工作流
通过自动适应导入到另一个
跨环境的批量操作

📝 文档与学习

自动生成工作流文档
通过AI指导学习n8n模式
探索工作流示例和模板

______________________________________________________________________

🔒 安全与最佳实践

凭证保护

✅ .config.json 通过git自动排除 .gitignore
✅ 从未记录API密钥（仅显示前20个字符）
✅ 由n8n API加密的凭据
✅ npm包中没有敏感数据

多实例安全

✅ 每个环境单独的API密钥
✅ 生产密钥与开发隔离
✅ API调用前的实例验证

安全操作

⚠️ IMPORTANT: Be careful with destructive operations!

- Always test in development first
- Use get_workflow to backup before modifications
- Review workflow details before deletion
- Enable debug mode for troubleshooting

______________________________________________________________________

🐛 故障排除

常见问题

MCP Server Connection Fails

症状： Claude/Cursor找不到n8n工具

解决：

重新启动克劳德桌面/光标IDE
检查 claude_desktop_config.json / .cursor/mcp.json 语法
验证n8n实例是否可访问
启用调试模式： DEBUG=true 在环境中

完整调试指南

404 Errors When Calling n8n API

症状： “请求失败，状态代码为404”

解决：

验证 n8n_host 使用基本URL（例如。， https://n8n.example.com)
不包括 /api/v1 后缀（服务器自动添加）
检查n8n API密钥是否具有正确的权限
测试连接性： curl https://your-n8n-instance.com/api/v1/workflows

配置指南

Workflow Activation Fails

症状： “没有有效触发器，无法激活工作流”

解决：

确保工作流至少有一个触发节点（webhook、日程表等）
manualTrigger 未被n8n API v1.82.3识别
如果缺少有效触发器，服务器会自动添加

错误参考

获取帮助

______________________________________________________________________

📊 最新动态

版本0.9.3（最新）-安全和文档

🔒 安全修复： 阻止日志文件发布到npm
📦 包装优化： 大小从699KB减小到653KB
📚 文档增强： 添加徽章并改进npm元数据
✅ API键旋转： 更新的安全实践

版本0.9.0-MCP协议合规性

✅ 完全支持MCP通知处理程序
✅ 固定的 “找不到方法'通知/初始化'”错误
📦 包装尺寸优化： 130万桶→ 278KB
🏗️ 多实例架构 智能路由
🔐 增强的凭证管理 使用模式验证

Epic 2完整版（13/13故事）-高级API实施

✅ 17 MCP工具 已实施（8个工作流+4个执行+5个标签+6个凭据）
✅ 100%测试成功率 在所有实现中
✅ 12000多行文档 有全面的例子
✅ 生产就绪质量 没有bug

查看完整变更日志

______________________________________________________________________

🗺️ 路线图

✅ 完成

\[x\] 核心工作流程CRUD操作
\[x\] 执行管理和监控
\[x\] 基于标签的工作流组织
\[x\] 多实例架构
\[x\] 凭证生命周期管理
\[x\] 综合文档网站（38+页）
\[x\] 使用CI/CD部署GitHub Pages

🚧 进行中

\[\]工作流模板库
\[\]增强的错误恢复模式
\[\]大型工作流的性能优化
\[\]高级过滤和搜索功能

🔮 计划的

\[\]可视化工作流编辑器集成
\[\]工作流版本控制和回滚
\[\]协同工作流开发
\[\]高级分析和见解
\[\]工作流市场和共享

建议功能

______________________________________________________________________

🤝 贡献

我们欢迎捐款！以下是您可以提供帮助的方式：

贡献方式

🐛 报告错误： 创建问题
💡 建议功能： 展开讨论
📖 改进文档： 提交文件改进
🔧 提交拉取请求： 修复错误或添加功能

开发设置

# Clone repository
git clone https://github.com/salacoste/mcp-n8n-workflow-builder.git
cd mcp-n8n-workflow-builder

# Install dependencies
npm install

# Build project
npm run build

# Run tests
npm test

# Start development server
npm run dev

代码规范

✅ TypeScript用于类型安全
✅ ESLint用于代码质量
✅ 格式化预处理
✅ Jest用于测试
✅ 常规承诺

贡献指南

______________________________________________________________________

📄 许可证

该项目根据 MIT许可证 -看看许可证文件以获取详细信息。

这意味着什么

✅ 商业用途 允许
✅ 修改允许
✅ 分布允许
✅ 私人使用 允许
⚠️ 无担保 提供
⚠️ 无责任 假定

完整许可证详细信息

______________________________________________________________________

🙏 致谢

内置：

🤖 克劳德·艾 -人工智能驱动的发展援助
🔧 n8n -工作流自动化平台
🔌 模型上下文协议 -AI集成标准
📝 TypeScript -类型安全开发
📚 MkDocs材料 -文件框架

特别感谢：

n8n团队致力于构建一个令人惊叹的自动化平台
Claude AI和MCP的Anthropic团队
所有提供反馈的贡献者和用户

______________________________________________________________________

📞 联系我们

🌐 文档： https://salacoste.github.io/mcp-n8n-workflow-builder/
📦 npm包： https://www.npmjs.com/package/@kernel.salacost/n8n-工作流构建器
💻 github： https://github.com/salacoste/mcp-n8n-workflow-builder
🐛 问题： https://github.com/salacoste/mcp-n8n-workflow-builder/issues
💬 讨论： https://github.com/salacoste/mcp-n8n-workflow-builder/discussions

______________________________________________________________________

⬆ 返回页首

由...制作❤️ 使用克劳德AI

⭐ 如果你觉得这很有用，请在repo上加星！

目录标签

工作流自动化JavaScriptClaudedeveloper-tools自动化工作流本地部署AI辅助开发多环境管理自然语言编程n8n集成

支持客户端

ClaudeCursorClaude Desktop

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Node.js

部署方式（deploymentType，部署类型）

remote-capable

来源包（packageName，安装包名）

@kernel.salacoste/n8n-workflow-builder

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdiononeremote-capable

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP.so

mcp.so

/server/mcp-n8n-workflow-builder/salacoste

MCP server for Claude / Cursor building n8n workflow

MCP World

mcpworld.com

/detail/11d46a593cafa1ebe759b74b3efae55a

通过自然语言交互实现n8n工作流的创建、管理和监控，支持多环境管理和17种工具覆盖完整工作流生命周期。

N8

Glama

glama.ai

/mcp/servers/salacoste/mcp-n8n-workflow-builder

Enables users to create, manage, and monitor n8n workflows through natural language using AI interfaces like Claude and Cursor. It supports multi-instance environments and provides tools for workflow lifecycle management, execution monitoring, and tag organization.

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

n8n Video Compilation MCP Server

Enables AI agents to create and manage video compilations through n8n workflows with smart query optimization, quality analysis, batch processing, and trusted channel filtering for platforms like YouTube.

下一个 MCP

N8n Workflow MCP

n8n工作流验证和管理的MCP服务器，支持多语言、工作流验证和搜索功能。

n8n Workflow Builder MCP Server

快速接入

详细介绍

n8n工作流生成器MCP服务器

通过自然语言实现人工智能驱动的工作流自动化

🎯 这是什么？

它解决的问题

解决方案

✨ 主要特点

🤖 人工智能驱动的工作流创建

🌍 多实例管理

🛠️ 17综合工具

💬 自然语言接口

🔒 设计安全

📚 综合文档

🚀 快速开始

先决条件

安装

配置

选项1：多实例（推荐）

选项2：单实例（向后兼容）

Claude桌面集成

游标IDE集成

📖 完整的文件

快速链接

🎨 例子

示例1：创建Webhook工作流

示例2：多实例工作流管理

示例3：调试失败的执行

示例4：凭证管理

🛠️ MCP工具参考

工作流管理（8个工具）

执行管理（4个工具）

标签管理（5个工具）

凭证管理（6个工具-Epic 2）

🏗️ 多实例架构

🎯 用例

🚀 开发工作流程

📊 运营与监控

🔄 工作流迁移

📝 文档与学习

🔒 安全与最佳实践

凭证保护

多实例安全

安全操作

🐛 故障排除

常见问题

获取帮助

📊 最新动态

版本0.9.3（最新）-安全和文档

版本0.9.0-MCP协议合规性

Epic 2完整版（13/13故事）-高级API实施

🗺️ 路线图

✅ 完成

🚧 进行中

🔮 计划的

🤝 贡献

贡献方式

开发设置

代码规范

📄 许可证

这意味着什么

🙏 致谢

📞 联系我们

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP