BrainHub
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: stac2026
特徴
🖥️ 統合パネル — 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 不要
アーキテクチャ構成
ディレクトリ | 責務 |
| FastAPI アプリ + Jinja2 テンプレート + WS; |
| ファイル CRUD + サムネイル、 |
| プロジェクト/タスク状態機械モデル |
| 運用エージェント:メモリ抽出、OpsAgent インターフェース、APScheduler 定期実行 |
| 名前付きパイプクライアント(BrainBridge と通信、envelope はプロトコル憲法 §3 に準拠) |
| fastmcp ゲートウェイ:独自ツール + BrainMem ツールの転送 |
|
|
クイックスタート
# 安装(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(コラボレーションゲートウェイ)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP gateway and cloud hosting for MCP servers, agents and apps like RAG, managed from your agent.
An MCP gateway for teams deploying AI tools at scale to employee-facing and headless agents.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides 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.-
- FlicenseNot gradedqualityDmaintenancePersonal AI infrastructure gateway orchestrating memory, workflow automation, knowledge retrieval, and skill discovery as a unified MCP stack.-
- AlicenseNot gradedqualityBmaintenanceMCP server providing persistent memory, semantic search, versioned storage, webhook fanout, and unified LLM routing for AI agents via FastAPI runtime with multiple backend options.35Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA FastAPI + FastMCP shared-memory gateway in front of Honcho v3 that provides a single shared brain for multiple AI agents to read from and write to, enabling context recall and change logging through bearer-authenticated endpoints.2MIT