BrainHub — 統合Webフロントエンド + クラウドストレージ + MCPゲートウェイ + 運用エージェント

Brain プロダクトファミリーの個人用メインエントリ：FastAPI 単一プロセスで全パネル（ナレッジベース / 検索 / クラウドストレージ / カンバン / メモリ / エージェント状態 / 運用ログ）を集約し、外部には単一の MCP ゲートウェイを提供、内蔵の運用エージェントがナレッジベースとメモリを自動維持します。

概要

BrainHub は Brain プロダクトファミリーの利用エントリであり、プロダクトファミリーの全機能を1つの操作可能なインターフェースと1セットの API に集約する役割を担います：

• Web パネル：Jinja2 + HTMX によるゼロフロントエンドビルド、ナレッジベース閲覧 / セマンティック検索 / クラウドストレージ CRUD / カンバンタスク状態機械 / メモリ / エージェント状態 / 運用ログ

• JSON API v1：/api/v1/* はデスクトップ版 React フロントエンドが呼び出し

• MCP ゲートウェイ：BrainHub 独自ツール + BrainMem 検索ツールを合わせて12個を集約、どのエージェントもこの1つのエントリにのみ接続

• 運用エージェント：定期アーカイブ、インデックス再構築、メモリ抽出、ヘルスチェック

自用期間中は brainhub start 1つでメインプロセスをすべて起動：brainmem をインポートして検索バックエンドとし、brain-bridge サブプロセスを起動、対外的には1つのソフトウェアのように動作します。

Related MCP server: MCPHub

特徴

• 🖥️ 統合パネル — 7種類のページを1つのサービスに集約、HTMX 部分更新 + Alpine 軽量インタラクション、フロントエンドビルドチェーン不要

• 🔌 単一 MCP エントリ — write_note / read_file / list_files / プロジェクト状態機械 / health_check / send_matrix_msg + BrainMem 検索ツールの転送

• 🤖 運用エージェント — APScheduler 定期実行：アーカイブ / インデックス再構築 / メモリ抽出 / ヘルスチェック、外部オーケストレーション不要

• 📁 クラウドストレージ — BRAIN_ROOT ファイルブラウズ、アップロード・ダウンロード、サムネイル遅延生成、範囲外・機密パス遮断

• 📋 カンバン — プロジェクト/タスク状態機械（todo → doing → blocked → done、厳格な遷移）

• 🔗 コラボレーション連携 — 名前付きパイプ経由で send_matrix_msg を BrainBridge daemon に転送、フロントエンド WS で Matrix メッセージとエージェント状態をリアルタイム受信

• 💻 デスクトップ版同一オリジンマウント — /app に brainhub-desktop のビルド成果物をマウント、同一オリジンで CORS 不要

アーキテクチャ構成

クイックスタート

# 安装（Python 3.10+，uv 管理；依赖 BrainMem editable 安装）
uv sync
uv pip install -e ../brainmem

# 启动（拉起 Web + MCP 网关 + brain-bridge 子进程）
uv run brainhub start

# 运维子命令
uv run brainhub ops archive
uv run brainhub ops reindex
uv run brainhub ops health

ドキュメント索引

• PLAN.md — 実装計画と現在の進捗（Phase 1-3 検収、パネル、運用 Cron、MCP ツール、依存関係）

• docs/protocol-constitution.md — プロトコル憲法：MCP ツールシグネチャ / memory.db schema / Matrix envelope

• ../brainmem/PRODUCT_FAMILY_PLAN.md — プロダクトファミリー全体 plan（プロダクト境界横断、HX470 移行、リスクトレードオフ）

関連プロジェクト

Brain プロダクトファミリー：BrainMem（メモリエンジン）· BrainHub（本リポジトリ）· BrainBridge（コラボレーションゲートウェイ）