内容
# Gemini n8n Kit
> 🚀 **The ultimate toolkit for orchestrating n8n workflows with Gemini CLI (Antigravity).**
This repository provides specialized **Skills** and **MCP Configurations** to turn your Gemini CLI into an expert n8n developer. It is inspired by the excellent work done for Claude by `czlonkowski`, but purely re-engineered for the Gemini ecosystem (March 2026 Edition).
## 📦 What's Inside?
### 1. n8n Expert Skill (`/skills/n8n-expert`)
A native Gemini Skill that teaches the agent:
* **Syntax Mastery:** No more broken `{{ $json... }}` expressions.
* **2026 AI Patterns:** Support for Agent Memory Graphs, Sub-Agent orchestration, and Human-in-the-loop validation.
* **Workflow Patterns:** Knows how to build resilient webhooks, API integrations, and advanced AI Agents.
* **Validation:** Auto-detects common mistakes before you even run the workflow.
### 2. n8n Architect Skill (`/skills/n8n-architect`)
*NEW* focus on high-level system design:
* **Modular Architecture:** Controller/Worker patterns.
* **State Management:** Best practices using external databases (Supabase/Postgres).
* **Handoff Documentation:** Leverages `n8n_generate_workflow_doc` for professional READMEs.
### 3. MCP Configuration (`/mcp-config`)
Plug-and-play configurations to connect Gemini CLI to your local or remote n8n instance via the Model Context Protocol (MCP).
## 🚀 Installation
### Prerequisites
* **Gemini CLI** (Antigravity) installed.
* **n8n** instance running (local or cloud).
* **Supergateway** (optional, but recommended for easy HTTP tunneling).
### Step 1: Install the Skills
You can install the skills directly from this repository locally:
```bash
gemini skills install ./skills/n8n-expert --scope user
gemini skills install ./skills/n8n-architect --scope user
```
### Step 2: Connect n8n (MCP)
Connect your n8n instance so Gemini can "see" and "control" your workflows. This kit is now optimized for the **official n8n MCP protocol**.
**Option A: Using Standard SSE (Recommended)**
This is the official transport protocol for the n8n MCP Client.
```bash
gemini mcp add n8n-mcp "http://localhost:3000/mcp" --header "Authorization: Bearer <YOUR_TOKEN>" --trust
```
**Option B: Using npx (Quick Local Setup)**
If you haven't deployed the server yet:
```bash
gemini mcp add n8n-mcp "npx -y n8n-mcp" --env "MCP_MODE=stdio" --env "N8N_API_URL=http://localhost:5678" --env "N8N_API_KEY=<YOUR_N8N_KEY>" --trust
```
## 🧠 How to Use
Once installed and reloaded (`/skills reload`), just talk to Gemini:
* *"Create a workflow that listens to a Webhook and sends a message to Slack."*
* *"Design a multi-workflow system for lead generation (n8n-architect)."*
* *"Generate technical documentation for workflow ID: abc-123."*
* *"Analyze my active workflows and suggest optimizations."*
## 🤝 Contribution
Fork this repo, improve the skills, and open a PR! Let's build the best n8n AI tooling together.
---
*Adapted for Gemini CLI by matheus-cabelo. Original concept by czlonkowski.*
