n8n-fabric

Workflow Automation Fabric Layer

n8n-fabric wraps n8n with an MCP server, Qdrant vector storage, and Redis caching—making workflows searchable, memorable, and orchestratable alongside git-steer and aiana.

Architecture

flowchart TB
    subgraph FABRIC["n8n-fabric"]
        direction TB
        mcp["MCP Server"]
        embed["Workflow Embedder"]
        cache["Cache Layer"]
    end

    subgraph N8N["n8n Engine"]
        api["REST API"]
        exec["Execution Engine"]
        nodes["500+ Nodes"]
    end

    subgraph STORAGE["Storage"]
        qdrant[("Qdrant\nWorkflow Vectors")]
        redis[("Redis\nCache & State")]
        postgres[("PostgreSQL\nn8n Data")]
    end

    subgraph ECOSYSTEM["ry-ops Fabric Ecosystem"]
        gitsteer["git-steer\nRepo Lifecycle"]
        aiana["aiana\nSemantic Memory"]
    end

    mcp --> api
    mcp --> embed
    mcp --> cache
    embed --> qdrant
    cache --> redis
    api --> exec
    exec --> nodes
    api --> postgres

    mcp <-.->|"MCP"| gitsteer
    mcp <-.->|"MCP"| aiana

    style FABRIC fill:#7C3AED,color:#fff
    style N8N fill:#FF6D5A,color:#fff
    style qdrant fill:#059669,color:#fff
    style redis fill:#DC2626,color:#fff
    style postgres fill:#336791,color:#fff

<p align="center"> <img src="./assets/n8n-fabric-architecture.svg" alt="n8n-fabric Architecture" width="100%"> </p>

---

Features

MCP Server

• Full n8n API access - Workflows, executions, credentials, nodes
• Semantic search - Find workflows by meaning, not just name
• Cross-fabric coordination - Works with git-steer and aiana

Workflow Intelligence

• Vector embeddings - Workflows stored in Qdrant for similarity search
• Pattern recognition - "How did I handle webhook → transform → API?"
• Playbook recall - Find and reuse proven workflow patterns

Infrastructure

• Docker Compose - One command to run full stack
• Redis caching - Fast workflow metadata and execution state
• PostgreSQL - n8n's persistent storage

---

Quick Start

Docker Compose (Recommended)

# Clone repository
git clone https://github.com/ry-ops/n8n-fabric
cd n8n-fabric

# Start full stack (n8n + Qdrant + Redis + PostgreSQL)
docker compose up -d

# Check status
docker compose ps

# View n8n UI
open http://localhost:5678

Local Development

# Install dependencies
uv sync

# Set environment variables
export N8N_URL=http://localhost:5678
export N8N_API_KEY=your-api-key

# Run MCP server
uv run n8n-fabric-mcp

---

MCP Tools

Workflow Management

Tool	Description
workflow_list	List all workflows with metadata
workflow_get	Get workflow by ID (full JSON)
workflow_create	Create new workflow from JSON
workflow_update	Update existing workflow
workflow_delete	Delete workflow
workflow_activate	Activate workflow
workflow_deactivate	Deactivate workflow
workflow_execute	Execute workflow manually
workflow_search	Semantic search across workflows

Execution Management

Tool	Description
execution_list	List executions with filters
execution_get	Get execution details and data
execution_delete	Delete execution
execution_retry	Retry failed execution
execution_stop	Stop running execution

Credentials & Nodes

Tool	Description
credential_list	List credential names (no secrets)
credential_create	Create new credential
credential_delete	Delete credential
node_types	List available node types
node_info	Get node type details

System & Status

Tool	Description
n8n_status	n8n health and version
fabric_status	Full stack health check
fabric_sync	Sync workflows to Qdrant

---

Configuration

Environment Variables

Variable	Description	Default
N8N_URL	n8n API URL	http://localhost:5678
N8N_API_KEY	n8n API key	(required)
QDRANT_URL	Qdrant URL	http://localhost:6343
REDIS_URL	Redis URL	redis://localhost:6389
N8N_ENCRYPTION_KEY	n8n encryption key	(required for production)

Note: Ports 6343 and 6389 are used to avoid conflicts with existing Qdrant/Redis instances.

Claude Desktop Integration

{
  "mcpServers": {
    "n8n-fabric": {
      "command": "uv",
      "args": ["run", "n8n-fabric-mcp"],
      "cwd": "/path/to/n8n-fabric"
    }
  }
}

---

Fabric Ecosystem

n8n-fabric is part of the ry-ops fabric ecosystem:

Fabric	Role	MCP Tools
n8n-fabric	Workflow execution, playbooks	Workflows, executions, credentials
git-steer	Repo lifecycle, version control	Repos, branches, security, PRs
aiana	Semantic memory, pattern recall	Memory search, context injection

Cross-Fabric Examples

"Remember how I built the Slack notification workflow"
  → aiana searches memory
  → n8n-fabric retrieves workflow
  → Returns full workflow JSON

"Create a new webhook-to-Slack workflow and commit it"
  → n8n-fabric creates workflow
  → git-steer commits workflow JSON to repo
  → aiana indexes for future recall

"Run my deployment notification playbook"
  → aiana recalls playbook pattern
  → n8n-fabric executes workflow
  → git-steer logs deployment

---

Documentation

• CLAUDE.md - AI assistant context
• Architecture - Technical design
• ADR-001 - Fabric design decisions

---

License

MIT License - see LICENSE file for details.

---

Repository: github.com/ry-ops/n8n-fabric

Status: Alpha - Initial Development

Version: 0.1.0

Updated: 2026-02-04