N8n Fabric

n8n面料

工作流自动化结构层

n8n结构将n8n与MCP服务器、Qdrant矢量存储和Redis缓存封装在一起，使工作流与git steer和aiana一起可搜索、可记忆和可编排。

建筑

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

______________________________________________________________________

特性

MCP服务器

• 完全n8n API访问 -工作流、执行、凭据、节点
• 语义搜索 -按含义查找工作流，而不仅仅是名称
• 跨结构协调 -适用于git steer和aiana

工作流智能

• 矢量嵌入 -存储在Qdrant中用于相似性搜索的工作流
• 模式识别 -“我是如何处理webhook的→ 变换→ API?"
• 剧本回忆 -查找并重用经过验证的工作流模式

基础设施

• Docker Compose -运行全栈的一个命令
• Redis缓存 -快速工作流元数据和执行状态
• PostgreSQL -n8n的持久存储

______________________________________________________________________

快速开始

Docker Compose（推荐）

# 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

本地开发

# 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工具

工作流管理

执行管理

凭据和节点

系统和状态

______________________________________________________________________

配置

环境变量

注： 端口6343和6389用于避免与现有Qdrant/Redis实例发生冲突。

Claude桌面集成

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

______________________________________________________________________

织物生态系统

n8n结构是ry-ops结构生态系统的一部分：

交叉织物示例

"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

______________________________________________________________________

文档

• CLAUDE.md -AI助手上下文
• 建筑 -技术设计
• ADR-001 -面料设计决策

______________________________________________________________________

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

存储库：

状态： Alpha-初始开发

版本： 0.1.0

更新： 2026-02-04