Fabric Docker

🚀 🧠 Fabric Docker

Fabric Docker 是一个一体化的 Docker 部署方案，用于 Fabric 这个具备 Web UI、REST API 和 MCP 服务器的 AI 增强框架。它能帮助用户快速搭建并使用 Fabric 相关服务。

✨ 主要特性

🚀 快速开始

# 克隆仓库
git clone https://github.com/neosun100/fabric-docker.git
cd fabric-docker

# 复制环境文件
cp .env.example .env

# 使用 Docker Compose 启动
docker compose up -d

# 访问服务
# Web UI:    http://localhost:5173
# REST API:  http://localhost:8180
# Swagger:   http://localhost:8180/swagger/index.html
# MCP:       http://localhost:8181

📦 安装指南

前提条件

• Docker 20.10 及以上版本
• Docker Compose 2.0 及以上版本
• 至少一个 AI 提供商的 API 密钥（如 OpenAI、Anthropic 等）

方法 1：使用 Docker Compose（推荐）

1. 克隆仓库

   git clone https://github.com/neosun100/fabric-docker.git
   cd fabric-docker
   

2. 配置环境

   cp .env.example .env
   # 编辑 .env 文件并添加你的 API 密钥
   

3. 启动服务

   docker compose up -d
   

4. 验证部署

   # 检查容器健康状态
   docker ps
   
   # 测试 API
   curl http://localhost:8180/patterns/names
   

方法 2：使用 Docker Run

# 拉取或构建镜像
docker build -t fabric:latest .

# 运行容器
docker run -d \
  --name fabric \
  -p 5173:8080 \
  -p 8180:8180 \
  -p 8181:8181 \
  -e OPENAI_API_KEY=your-key-here \
  -e ANTHROPIC_API_KEY=your-key-here \
  -v fabric-config:/root/.config/fabric \
  fabric:latest

⚙️ 配置

环境变量

docker-compose.yml

services:
  fabric:
    build:
      context: .
      dockerfile: Dockerfile
    image: neosun/fabric:latest
    container_name: fabric
    restart: unless-stopped
    ports:
      - "5173:8080"    # Web UI
      - "8180:8180"    # REST API
      - "8181:8181"    # MCP Server
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-}
      - DEFAULT_MODEL=gpt-4o
    volumes:
      - fabric-config:/root/.config/fabric
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8180/patterns/names"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  fabric-config:

💻 使用示例

Web UI

访问 http://localhost:5173 上的 Web 界面：

• 浏览和搜索 233+ 种模式
• 使用自定义输入执行模式
• 管理上下文和会话
• 实时聊天界面

REST API

# 列出所有模式
curl http://localhost:8180/patterns/names

# 获取特定模式
curl http://localhost:8180/patterns/summarize

# 检查模式是否存在
curl http://localhost:8180/patterns/exists/summarize

# 获取可用模型
curl http://localhost:8180/models/names

# 获取配置
curl http://localhost:8180/config

# 获取策略
curl http://localhost:8180/strategies

API 端点

MCP 集成

MCP 服务器使 AI 助手（如 Claude Desktop）能够直接使用 Fabric 模式。

在你的 MCP 客户端中进行配置：

{
  "mcpServers": {
    "fabric": {
      "url": "http://localhost:8181"
    }
  }
}

🏗️ 架构

┌─────────────────────────────────────────────────────────┐
│                    Docker 容器                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │   Web UI    │  │  REST API   │  │ MCP 服务器  │     │
│  │   (Node)    │  │   (Go)      │  │  (Python)   │     │
│  │   :8080     │  │   :8180     │  │   :8181     │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│         │                │                │             │
│         └────────────────┼────────────────┘             │
│                          │                              │
│              ┌───────────┴───────────┐                  │
│              │    Fabric 核心        │                  │
│              │  (233+ 模式)          │                  │
│              └───────────────────────┘                  │
└─────────────────────────────────────────────────────────┘
         │              │              │
    端口 5173      端口 8180      端口 8181

🔧 技术细节

📁 项目结构

fabric-docker/
├── Dockerfile              # 多阶段构建
├── docker-compose.yml      # Compose 配置
├── docker/
│   ├── entrypoint.sh      # 容器入口点
│   ├── supervisord.conf   # 进程管理器配置
│   ├── mcp_server.py      # MCP 服务器实现
│   └── nginx.conf         # Nginx 配置（可选）
├── data/
│   ├── patterns/          # 233+ AI 模式
│   └── strategies/        # 提示策略
├── web/                   # Svelte Web UI
├── cmd/                   # Go 命令
├── internal/              # Go 内部包
└── docs/                  # 文档

🔧 故障排除

容器显示 "unhealthy"

# 查看日志
docker logs fabric

# 重启 fabric-api 服务
docker exec fabric supervisorctl restart fabric-api

# 验证端口
docker exec fabric netstat -tlnp

API 无响应

# 检查服务是否正在运行
docker exec fabric supervisorctl status

# 手动重启
docker compose restart

端口冲突

编辑 .env 文件以更改端口映射：

PORT=8280
WEB_PORT=5273
MCP_PORT=8281

🤝 贡献

欢迎贡献！请随时提交拉取请求。

1. 分叉仓库
2. 创建你的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开拉取请求

📄 许可证

本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• Fabric - 原始的 AI 增强框架
• Daniel Miessler - Fabric 的创建者

⭐ 星标历史

📱 关注我