Skip to main content
Glama

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 不要

アーキテクチャ構成

ディレクトリ

責務

web/

FastAPI アプリ + Jinja2 テンプレート + WS;routes/api.py はデスクトップ版 JSON API v1

storage/

ファイル CRUD + サムネイル、write_note アーカイブ、共有 memory.db の遅延ロード Store

projects/

プロジェクト/タスク状態機械モデル

ops/

運用エージェント:メモリ抽出、OpsAgent インターフェース、APScheduler 定期実行

pipe/

名前付きパイプクライアント(BrainBridge と通信、envelope はプロトコル憲法 §3 に準拠)

mcp.py

fastmcp ゲートウェイ:独自ツール + BrainMem ツールの転送

cli.py

brainhub start / stop / status + ops サブコマンド

クイックスタート

# 安装(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(コラボレーションゲートウェイ)

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    Provides a unified MCP interface that proxies requests to multiple backend servers including memory/knowledge graph and vector database services. Enables seamless access to distributed MCP tools through a single endpoint with automatic routing, health monitoring, and retry logic.
    -
  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    A unified gateway and dashboard that aggregates multiple MCP servers into a single endpoint for streamlined management by AI clients. It features a centralized YAML configuration, a web-based monitoring dashboard, and hot-reload support for managing filesystem, GitHub, and database tools.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Personal AI infrastructure gateway orchestrating memory, workflow automation, knowledge retrieval, and skill discovery as a unified MCP stack.
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server providing persistent memory, semantic search, versioned storage, webhook fanout, and unified LLM routing for AI agents via FastAPI runtime with multiple backend options.
    34
    Apache 2.0