n8n builder

n8n工作流生成器

Claude Code工作区，用于使用AI驱动的工具和技能构建生产就绪的n8n工作流。

特性

• n8n MCP服务器 -通过MCP直接访问n8n文档、节点属性和工作流管理
• 7专业技能 -表达式、验证、模式和代码节点的上下文感知指南
• API集成 -直接在n8n实例上创建、更新、执行和管理工作流
• 模板库 -从2700多个工作流模板中搜索和部署

快速开始

先决条件

• v18+已安装
• 克劳德代码 CLI或VS代码扩展
• 具有API访问权限的n8n实例（自托管或云）
• GitHub CLI（可选，用于仓库管理）

安装

1. 克隆此存储库

   git clone https://github.com/CyberParv/n8n_builder.git
   cd n8n_builder

1. 配置n8n API凭据

编辑 .mcp.json 并添加您的n8n实例详细信息：

   {
     "mcpServers": {
       "n8n-mcp": {
         "command": "npx",
         "args": ["n8n-mcp"],
         "env": {
           "MCP_MODE": "stdio",
           "LOG_LEVEL": "error",
           "DISABLE_CONSOLE_OUTPUT": "true",
           "N8N_API_URL": "https://your-n8n-instance.com",
           "N8N_API_KEY": "your-api-key-here"
         }
       }
     }
   }

1. 在此目录中启动Claude Code

   claude

1. 验证设置

- MCP服务器应自动初始化 - 技能将根据上下文激活

设置检查表

在构建工作流之前，请验证：

• \[\]已安装Node.js v18+(node --version)
• \[\]n8n MCP服务器初始化时没有错误
• \[\]API凭据在中配置 .mcp.json
• \[\]可以连接到n8n实例
• \[\]技能目录存在(n8n-skills/skills/)
• \[\]GitHub CLI已通过身份验证（可选： gh auth status)

项目结构

n8n_builder/
├── .mcp.json              # MCP server configuration
├── CLAUDE.md              # Claude Code instructions (auto-loaded)
├── README.md              # This file
├── SETUP.md               # Detailed setup guide
├── prompts/               # Reusable prompts for common tasks
│   ├── create-workflow.md
│   ├── debug-workflow.md
│   └── optimize-workflow.md
└── n8n-skills/            # Cloned skills repository
    └── skills/
        ├── n8n-code-javascript/
        ├── n8n-code-python/
        ├── n8n-expression-syntax/
        ├── n8n-mcp-tools-expert/
        ├── n8n-node-configuration/
        ├── n8n-validation-expert/
        └── n8n-workflow-patterns/

可用的MCP工具

文件和参考

工作流管理（需要API）

技能参考

示例提示

创建新工作流

Create a workflow that:
1. Triggers on webhook POST to /orders
2. Validates the order data
3. Saves to PostgreSQL database
4. Sends Slack notification on success
5. Handles errors gracefully

调试现有工作流

Debug workflow ID: abc123
- Check for validation errors
- Verify node connections
- Test with sample data

优化性能

Analyze workflow "Daily Report Generator" for:
- Unnecessary API calls
- Missing error handling
- Optimization opportunities

获取n8n API密钥

自托管n8n

1. 转到“设置”→ API
2. 创建新的API密钥
3. 将密钥复制到 .mcp.json

n8n云

1. 转到“设置”→ API
2. 生成新的API密钥
3. 将密钥复制到 .mcp.json

故障排除

MCP服务器未启动

# Test manually
npx n8n-mcp

API连接失败

• 验证 N8N_API_URL 正确（包括https://）
• 检查API密钥是否具有正确的权限
• 确保n8n实例可访问

技能未加载

• 验证 n8n-skills/skills/ 目录存在
• 检查技能档案是否 .md 扩展
• 重新启动Claude代码

贡献

1. 克隆该仓库
2. 创建要素分支
3. 提交拉取请求

资源

• n8n文档
• n8n MCP服务器
• n8n技能
• 克劳德代码

许可证

MIT许可证-有关详细信息，请参阅许可证文件。