n8n-技能i

使用 n8n-mcp MCP 服务器构建完美 n8n 工作流的 Claude Code 专家技能

观看介绍视频

---

🎯 这是什么？

此仓库包含 7 个互补的 Claude Code 技能，教授 AI 助手如何使用 n8n-mcp MCP 服务器构建生产就绪的 n8n 工作流。

为什么需要这些技能

以编程方式构建 n8n 工作流可能颇具挑战性。常见问题包括：

• 不正确或低效地使用 MCP 工具
• 卡在验证错误循环中
• 不知道该使用哪些工作流模式
• 节点及其依赖关系配置不当

这些技能通过教导 Claude 解决这些问题：

• ✅ 正确的 n8n 表达式语法（{{}} 模式）
• ✅ 如何有效使用 n8n-mcp 工具
• ✅ 来自实际应用的成熟工作流模式
• ✅ 验证错误的解读与修复
• ✅ 具备操作意识的节点配置

---

📚 7 个技能

1. n8n 表达式语法

教授正确的 n8n 表达式语法及常用模式。

触发条件：编写表达式、使用 {{}} 语法、访问 $json/$node 变量、排查表达式错误。

关键特性：

• 核心变量（$json、$node、$now、$env）
• 重要陷阱：Webhook 数据位于 $json.body 下
• 常见错误及其修复方法
• 何时不使用表达式（代码节点！）

2. n8n MCP 工具专家（最高优先级）

高效使用 n8n-mcp MCP 工具的专家指南。

触发条件：搜索节点、验证配置、访问模板、管理工作流。

关键特性：

• 工具选择指南（不同任务对应不同工具）
• nodeType 格式差异（nodes-base.* vs n8n-nodes-base.*）
• 验证配置文件（最小化/运行时/AI友好/严格）
• 智能参数（IF 节点中的 branch="true"）
• 自动清理系统详解

最重要：教授正确的 MCP 工具使用模式和参数格式。

3. n8n 工作流模式

使用 5 种成熟的架构模式构建工作流。

触发条件：创建工作流、连接节点、设计自动化流程。

关键特性：

• 5 种成熟模式（Webhook 处理、HTTP API、数据库、AI、定时任务）
• 工作流创建检查清单
• 来自 2,653+ 个 n8n 模板的真实示例
• 连接最佳实践
• 模式选择指南

4. n8n 验证专家

解读验证错误并指导修复。

触发条件：验证失败、调试工作流动画、处理误报。

关键特性：

• 验证循环工作流
• 真实错误目录
• 自动清理行为解释
• 误报处理指南
• 不同阶段的配置文件选择

5. n8n 节点配置

提供具备操作意识的节点配置指导。

触发条件：配置节点、理解属性依赖关系、设置 AI 工作流。

关键特性：

• 属性依赖规则（例如 sendBody → contentType）
• 特定操作要求
• AI 连接类型（AI Agent 工作流有 8 种类型）
• 常见配置模式

6. n8n 代码 JavaScript

在 n8n 代码节点中编写高效的 JavaScript 代码。

触发条件：在代码节点中编写 JavaScript、排查代码节点错误、使用 $helpers 发起 HTTP 请求、处理日期。

关键特性：

• 数据访问模式（$input.all()、$input.first()、$input.item）
• 重要陷阱：Webhook 数据位于 $json.body 下
• 正确的返回格式：[{json: {...}}]
• 内置函数（$helpers.httpRequest()、DateTime、$jmespath()）
• 前 5 种错误模式及解决方案（覆盖 62% 以上的故障）
• 10 种经过生产验证的模式

7. n8n 代码 Python

在 n8n 代码节点中编写 Python 代码，并充分了解其限制。

触发条件：在代码节点中编写 Python、需要了解 Python 的限制、使用标准库。

关键特性：

• 重要提示：95% 的场景应使用 JavaScript
• Python 数据访问（_input、_json、_node）
• 关键限制：无法使用外部库（requests、pandas、numpy）
• 标准库参考（json、datetime、re 等）
• 缺失库的替代方案
• n8n 中常见的 Python 模式

---

🚀 安装

先决条件

1. 已安装并配置好 n8n-mcp MCP 服务器（安装指南）
2. 拥有 Claude Code、Claude.ai 或 Claude API 访问权限
3. 配置好 .mcp.json 文件，使其指向 n8n-mcp 服务器

Claude Code

方法 1：插件安装（推荐）

# 直接作为 Claude Code 插件安装
/plugin install czlonkowski/n8n-skills

方法 2：通过市场

# 添加到市场，然后浏览并安装
/plugin marketplace add czlonkowski/n8n-skills

# 接着浏览可用插件
/plugin install
# 从列表中选择 "n8n-mcp-skills"

方法 3：手动安装

# 1. 克隆此仓库
git clone https://github.com/czlonkowski/n8n-skills.git

# 2. 将技能复制到你的 Claude Code 技能目录
cp -r n8n-skills/skills/* ~/.claude/skills/

# 3. 重新加载 Claude Code
# 技能将自动激活

Claude.ai

1. 从 skills/ 下载各个技能文件夹
2. 将每个技能文件夹压缩成 ZIP 文件
3. 通过设置 → 功能 → 技能上传

API / SDK

详细说明请参阅 docs/INSTALLATION.md。

---

💡 使用方法

当检测到相关查询时，技能会 自动 激活：

“如何编写 n8n 表达式？”
→ 激活：n8n 表达式语法

“帮我找一个 Slack 节点”
→ 激活：n8n MCP 工具专家

“构建一个 Webhook 工作流”
→ 激活：n8n 工作流模式

“为什么验证失败？”
→ 激活：n8n 验证专家

“如何配置 HTTP 请求节点？”
→ 激活：n8n 节点配置

“如何在代码节点中访问 Webhook 数据？”
→ 激活：n8n 代码 JavaScript

“我能在 Python 代码节点中使用 pandas 吗？”
→ 激活：n8n 代码 Python

技能协同工作

当你询问：“构建并验证一个 Webhook 到 Slack 的工作流”

1. n8n 工作流模式识别出 Webhook 处理模式
2. n8n MCP 工具专家搜索 Webhook 和 Slack 节点
3. n8n 节点配置指导节点设置
4. n8n 代码 JavaScript帮助处理 Webhook 数据，并正确访问 .body
5. n8n 表达式语法协助其他节点进行数据映射
6. n8n 验证专家验证最终的工作流

所有技能无缝协作！

---

📖 文档

• 安装指南 - 适用于所有平台的详细安装说明
• 使用指南 - 如何高效使用技能
• 开发指南 - 贡献与测试
• MCP 测试日志 - 技能在实际中使用的工具响应

---

🧪 测试

每项技能都包含3次以上的评估以确保质量：

# 运行评估（如果测试框架可用）
npm test

# 或者手动使用 Claude 测试
claude-code --skill n8n-expression-syntax "测试 webhook 数据访问"

---

🤝 贡献

欢迎贡献！请参阅 DEVELOPMENT.md 获取相关指南。

开发方法

1. 评估优先：在实现之前先编写测试场景
2. 基于 MCP：测试工具，记录真实响应
3. 迭代式：根据评估进行测试，反复迭代直至100%通过
4. 简洁明了：保持 SKILL.md 不超过500行
5. 真实示例：所有示例均来自真实的模板或工具

---

📝 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

---

🙏 致谢

构思者：Romuald Członkowski

• 官网：www.aiadvisors.pl/en
• 属于 n8n-mcp 项目

---

🔗 相关项目

• n8n-mcp - 用于 n8n 的 MCP 服务器
• n8n - 工作流自动化平台

---

📊 包含内容

• 7 个相辅相成、协同工作的技能
• 525+ 个支持的 n8n 节点
• 2,653+ 个工作流模板作为示例
• 10 种经过生产环境验证的 Code 节点模式
• 全面的 错误目录和故障排除指南

---

准备好构建无瑕的 n8n 工作流了吗？立即开始吧！ 🚀

n8n-skills 快速上手指南

n8n-skills 是一套专为 Claude Code 设计的专家级技能包，旨在结合 n8n-mcp 服务器，帮助开发者构建无缺陷、生产级的 n8n 工作流。它包含 7 个互补技能，涵盖表达式语法、MCP 工具使用、工作流模式、错误验证及代码节点编写等核心领域。

环境准备

在开始之前，请确保满足以下前置条件：

1. n8n-mcp 服务器：已安装并正确配置。
   • 参考项目：n8n-mcp
2. Claude 访问权限：拥有 Claude Code、Claude.ai 或 Claude API 的访问权限。
3. 配置文件：已在 .mcp.json 中配置好 n8n-mcp 服务器连接。

安装步骤

推荐通过 Plugin Installation 方式直接安装，也可选择手动安装。

方法一：插件安装（推荐）

在终端中运行以下命令，直接将技能包安装为 Claude Code 插件：

/plugin install czlonkowski/n8n-skills

或者通过市场添加后安装：

# 添加到市场源
/plugin marketplace add czlonkowski/n8n-skills

# 浏览并选择安装
/plugin install
# 在列表中选择 "n8n-mcp-skills"

方法二：手动安装

如果无法使用插件命令，可手动克隆仓库：

# 1. 克隆仓库
git clone https://github.com/czlonkowski/n8n-skills.git

# 2. 将技能文件复制到 Claude Code 技能目录
cp -r n8n-skills/skills/* ~/.claude/skills/

# 3. 重启或重载 Claude Code，技能将自动激活

针对 Claude.ai 用户

1. 从仓库的 skills/ 目录下载各个技能文件夹。
2. 将每个技能文件夹分别压缩为 ZIP 包。
3. 在 Claude.ai 中进入 Settings → Capabilities → Skills 上传 ZIP 包。

基本使用

安装完成后，技能会根据你的提问内容自动激活，无需手动切换。以下是几个典型的使用场景：

1. 查询表达式语法

当你需要编写 n8n 表达式或处理变量时：

输入示例："如何在 n8n 中编写表达式？Webhook 数据在哪里？” 自动激活：n8n Expression Syntax 效果：提供 $json, $node 等核心变量用法，并提示 Webhook 数据位于 $json.body 的关键细节。

2. 查找与配置节点

当你需要寻找特定节点或配置参数时：

输入示例：“帮我找一个 Slack 节点并配置它。” 自动激活：n8n MCP Tools Expert & n8n Node Configuration 效果：指导如何使用 MCP 工具搜索节点，区分 nodes-base 格式，并提供操作感知的配置建议。

3. 构建完整工作流

当你需要从头创建一个自动化流程时：

输入示例：“构建一个接收 Webhook 并发送到 Slack 的工作流。” 自动激活：所有相关技能协同工作 执行逻辑：

1. n8n Workflow Patterns 识别 Webhook 处理模式。
2. n8n MCP Tools Expert 搜索所需节点。
3. n8n Node Configuration 指导节点设置。
4. n8n Code JavaScript 协助处理数据映射（如正确访问 .body）。
5. n8n Validation Expert 最终验证工作流并修复潜在错误。

4. 编写代码节点

当你需要在 Code 节点中编写 JavaScript 或 Python 时：

输入示例：“如何在 Code 节点中发起 HTTP 请求？”或"Python 节点能用 pandas 吗？” 自动激活：n8n Code JavaScript 或 n8n Code Python 效果：提供生产级代码模板，指出 Python 不支持外部库的限制，并给出标准库替代方案。

---

提示：技能之间会自动协作。对于复杂任务（如“构建并验证一个工作流”），多个技能会按顺序介入，确保从设计到验证的全流程无误。