N8n Workflow SDK MCP

n8n工作流sdk MCP

使用Claude Code以编程方式管理n8n工作流的模板——使用MCP服务器工作流，让Claude使用TypeScript作为创作语言直接读取和更新您的n8n工作流程。

此模板旨在与 n8n工作流sdk-Claude代码技能，教授Claude完整的SDK API、正确的节点模式以及在TypeScript中创作n8n工作流的验证指南。

这是什么

此模板为您提供：

• Claude Code项目说明 (CLAUDE.md)--教Claude TypeScript工作流约定、已知的SDK怪癖，以及如何通过MCP与n8n实例交互
• n8n MCP服务器工作流 (n8n-workflow/)--您导入n8n的工作流，该工作流公开 search_workflows, get_workflow, create_workflow，以及 update_workflow 通过MCP向Claude提供工具
• Playwright浏览器集成 --每次创建或更新工作流后，Claude都会在浏览器中打开工作流。你也可以让克劳德在任何时候目视检查画布。
• 可重复的模式 用于人工智能辅助的工作流创作、修改和部署

SDK如何融入

这 @n8n/workflow-sdk 是 不 您在本地安装的东西。它存在于MCP服务器工作流本身中，嵌入在代码节点中：

• search_workflows --按名称搜索工作流，并返回一个包含ID和元数据的列表
• get_workflow --从n8n检索工作流的JSON，并使用SDK将其转换为TypeScript，然后返回给Claude
• create_workflow --从Claude接收TypeScript，使用SDK将其转换为n8n JSON，并创建新的工作流
• update_workflow --从Claude接收TypeScript，使用SDK将其解析回n8n JSON，并将更新推送到现有工作流

Claude完全使用TypeScript，从不处理原始n8n JSON。转换在n8n工作流中透明地进行。

先决条件

• 克劳德代码 安装
• n8n实例（自托管） 2.9.0或更高版本
• 在n8n实例上设置以下环境变量，以允许在Code节点内使用SDK：

  NODE_FUNCTION_ALLOW_EXTERNAL="@n8n/workflow-sdk"

• 这 n8n工作流sdk技能 安装在Claude Code中（见步骤8）

设置

1.克隆此存储库

克隆此存储库并导航到终端中的克隆文件夹。

2.配置n8n实例

将以下环境变量添加到n8n实例中并重新启动它：

NODE_FUNCTION_ALLOW_EXTERNAL="@n8n/workflow-sdk"

3.导入和发布MCP工作流

导入 n8n-workflow/n8n workflow-sdk MCP.json 将其发布到n8n实例中。

4.使用Claude Code注册MCP服务器

打开 MCP触发器 节点，复制 生产URL，并从克隆的存储库文件夹中在终端中运行以下命令：

claude mcp add --transport sse n8n-workflows 

5.安装Playwright MCP服务器

在同一个终端中，运行：

claude mcp add playwright-mcp npx @executeautomation/playwright-mcp-server

6.更新CLAUDE.md

替换所有出现的 https://your-n8n-instance.com/ 使用您的n8n基本URL（出现两次）。

7.打开克劳德代码

在克隆的存储库文件夹中，打开Claude Code。所有MCP服务器现在从一开始就可用。

8.安装n8n工作流sdk技能

👉 在此处安装n8n工作流sdk技能 并按照安装说明进行操作。

之后关闭并重新打开Claude Code，以便技能完全加载。

运作原理

一旦设置好，只需自然地与Claude Code交谈即可。你可以说得很具体，也可以不干涉——剩下的由克劳德处理。

一次性委派所有任务：

“找到名为“发票处理器”的工作流，并将手动触发器替换为webhook。”

Claude将搜索、检索、更改、推回并在浏览器中打开它。

或者一步一步地走：

1. 搜索 --让Claude按名称查找工作流。它返回一个包含名称和ID的列表，以便您可以选择正确的一个。
2. 检索和检查 --Claude将工作流作为TypeScript获取。在触碰任何东西之前，你可以让克劳德解释、回顾或提出改进建议。
3. 修改 --告诉克劳德要更改什么：交换节点、添加步骤、更新凭据、重新连接。Claude相应地编辑了TypeScript。
4. 推 --Claude会自动将更新的工作流发送回n8n。
5. 审查 --Claude在浏览器中打开工作流。你也可以让克劳德看看画布并给出反馈。

你也可以让克劳德 创建全新的工作流程 从头开始——描述一下它应该做什么。

使用它没有对错之分。你可以控制你委派了多少。