MCP 服务器

n8n-fabric

Wraps n8n with an MCP server and vector storage to enable semantic search, management, and execution of automated workflows. It integrates with other tools to make workflows searchable and orchestratable within a larger automation ecosystem.

README

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

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