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: 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 不要
アーキテクチャ構成
ディレクトリ | 責務 |
| 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(コラボレーションゲートウェイ)
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
NeuralBrain MCP Server - RAG, Vector Memory, LLM Routing, Agent Identity, x402 Payments
The project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.
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.-
- AlicenseNot gradedqualityNot gradedmaintenanceA 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.-
- 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.34Apache 2.0