n8n AI工作流自动化

Prerequisites

• Node.js v14+ (v18+ recommended)
• npm v7+
• n8n instance with API access (tested with n8n v1.82.3+)
• Claude Desktop or Cursor IDE

Install dependencies

npm install

n8n Workflow Builder MCP Server

Installation

```bash

Install globally via npm

npm install -g @kernel.salacoste/n8n-workflow-builder

Verify installation

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

Development Setup

```bash

Build project

npm run build

🚀 Quick Start

🎨 Examples

Example 1: Create a Webhook Workflow

You: > Create a webhook workflow in staging that: > - Receives POST requests at /customer-signup > - Validates email and name fields > - Sends welcome email via Gmail > - Stores customer in PostgreSQL

Claude: ✅ Creates complete workflow with validation, email, and database nodes

Example 2: Multi-Instance Workflow Management

You: > List all active workflows in production that haven't run in the last 7 days

Claude: 📊 Analyzes production environment and identifies stale workflows

Example 3: Debug Failed Executions

You: > Debug workflow 456 in production - it's been failing with errors

Claude: 🔍 Retrieves execution history, identifies root cause, and suggests fixes

Example 4: Credential Management

You: > Show me the schema for OAuth2 credentials, then help me create credentials for Google Sheets API

Claude: 🔐 Retrieves credential schema and guides you through secure credential creation

---

🎯 Use Cases

Configuration

Option 1: Multi-Instance (Recommended)

Create .config.json in your project root:

{
  "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"
}

Option 2: Single Instance (Backward Compatible)

Create .env file:

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

💬 Natural Language Interface

No JSON editing required. Build workflows like this:

"Create a webhook workflow that validates customer emails, sends a Slack notification, and stores data in PostgreSQL"

🛠️ MCP Tools Reference

Epic 2 Complete (13/13 Stories) - Advanced API Implementation

• ✅ 17 MCP Tools implemented (8 workflows + 4 executions + 5 tags + 6 credentials)
• ✅ 100% test success rate across all implementations
• ✅ 12,000+ lines of documentation with comprehensive examples
• ✅ Production-ready quality with zero bugs

View Full Changelog

---

AI-Powered Workflow Automation Through Natural Language

Build, manage, and monitor n8n workflows using Claude AI and Cursor IDE via the Model Context Protocol

Features • Quick Start • Documentation • Examples • API Reference

</div>

---

🤖 AI-Powered Workflow Creation

Create complex n8n workflows by simply describing what you need. Claude AI and Cursor IDE understand your intent and generate production-ready workflows.

Claude Desktop Integration

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Restart Claude Desktop and you're ready to go! 🎉

Cursor IDE Integration

Add to .cursor/mcp.json in your workspace:

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

---

Workflow Management (8 tools)

🚀 Development Workflow

1. Build in Development: Create and test workflows locally
2. Deploy to Staging: Validate in QA environment
3. Promote to Production: Deploy with confidence

🔄 Workflow Migration

• Export workflows from one instance
• Import to another with automatic adaptation
• Bulk operations across environments

🐛 Troubleshooting