Fabric Docker

🚀 🧠 Fabric Docker

Fabric のAll-in-One Dockerデプロイです。Web UI、REST API、MCPサーバーを備えたAI拡張フレームワークです。

English | 简体中文 | 繁體中文 | 日本語

✨ 主な機能

🚀 クイックスタート

# リポジトリをクローンする
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以上
• 少なくとも1つの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 Container                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │   Web UI    │  │  REST API   │  │ MCP Server  │     │
│  │   (Node)    │  │   (Go)      │  │  (Python)   │     │
│  │   :8080     │  │   :8180     │  │   :8181     │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│         │                │                │             │
│         └────────────────┼────────────────┘             │
│                          │                              │
│              ┌───────────┴───────────┐                  │
│              │    Fabric Core        │                  │
│              │  (233+ Patterns)      │                  │
│              └───────────────────────┘                  │
└─────────────────────────────────────────────────────────┘
         │              │              │
    Port 5173      Port 8180      Port 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の作成者

⭐ スター履歴

📱 フォロー