Skip to main content
Glama

BrainHub — Einheitliches Web-Frontend + Netzlaufwerk + MCP-Gateway + Ops-Agent

Selbstgenutzter Haupteinstieg der Brain-Produktfamilie: Ein einzelner FastAPI-Prozess bündelt alle Panels (Wissensdatenbank / Suche / Netzlaufwerk / Kanban / Gedächtnis / Agent-Status / Betriebsprotokolle), stellt nach außen ein einziges MCP-Gateway bereit und enthält einen eingebauten Ops-Agent, der Wissensdatenbank und Gedächtnis automatisch pflegt.

Einführung

BrainHub ist der Nutzungseinstieg der Brain-Produktfamilie. Er bündelt alle Fähigkeiten der Produktfamilie in einer bedienbaren Oberfläche und einem Satz von APIs:

  • Web-Panel: Jinja2 + HTMX ohne Frontend-Erstellung, Wissensdatenbank-Browsing / semantische Suche / Netzlaufwerk CRUD / Kanban-Aufgabenstatemachine / Team / Agent-Status / Ops-Protokolle

  • JSON API v1: /api/v1/* für den React-Desktop-Client

  • MCP-Gateway: Aggregiert 12 eigene BrainHub-Tools + BrainMem-Websitesuchwerkzeuge; jeder Agent verbindet nur diesen einen Einstieg

  • Ops-Agent: Geplante Archivierung, Index-Neuaufbau, Gedächtnisextraktion, Health-Check

Im Selbstnutzungszeitraum startet ein brainhub start alle Hauptprozesse: importiert brainmem als Retrieval-Backend, startet den brain-bridge-Subprozess und wirkt nach außen wie eine Software.

Related MCP server: MCPHub

Eigenschaften

  • 🖥️ Einheitliches Panel — 7 Seitentypen in einem Dienst zusammengefasst, HTMX-Partial-Refresh + Alpine, kein Frontend-Build-Chain

  • 🔌 Einziger MCP-Einstieg — write_note / read_file / list_files / Projekt-Statemachine / health_check / send_matrix_msg + Weiterleitung der BrainMem-Suchwerkzeuge

  • 🤖 Ops-Agent — APScheduler-basiert planbar: Archivierung / Index-Neuaufbau / Gedächtnisextraktion / Health Check, keine externe Orchestrierung

  • 📁 Netzlaufwerk — BRAIN_ROOT-Dateibrowsing, Hochladen/Herunterladen, Thumbnail-Lazy-Generierung, Blockierung von Pfaden außerhalb des Bereichs und sensiblen Pfaden

  • 📋 Kanban — Projekt-/Aufgabenstatemachine (todo → doing → blocked → done, strikte Übergänge)

  • 🔗 Kollaborationsanbindung — leitet send_matrix_msg über Named Pipe an den BrainBridge-Daemon weiter, das Frontend empfängt Matrix-Nachrichten und Agent-Status in Echtzeit per WS

  • 💻 Desktop-Same-Origin-Mounting — /app mountet die Build-Artefakte von brainhub-desktop, Same-Origin ohne CORS

Architektur

Verzeichnis

Zuständigkeit

web/

FastAPI-Anwendung + Jinja2-Vorlagen + WS; routes/api.py ist die JSON API v1 für den Desktop-Client

storage/

Datei- CRUD + Thumbnails, write_note-Archiv, lazy-loading Store mit gemeinsamem memory.db

projects/

Projekt-/Aufgaben-Statusmaschinen-Modell

ops/

Ops-Agent: Gedächtnisextraktion, OpsAgent-Schnittstelle, APScheduler-Plan

pipe/

Named-Pipe-Client (kommuniziert mit dem Brain-Bridge, Envelope-UTF-8)

mcp.py

fastmcp-Gateway: eigene Werkzeuge + BrainMem-Werkzeuge

cli.py

brainhub start / stop / status + ops-Subcommand

Schnellstart

# 安装(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

Dokumentationsindex

  • PLAN.md — Implementierungsplan und aktueller Stand (Phase 1-3-Abnahme, Panels, Ops-Cron, MCP-Tool, Dependencies)

  • docs/protocol-constitution.md — Protokoll-Verfassung: MCP-Toolsignatur / memory.db Schema / Matrix-Envelope

  • ../brainmem/PRODUCT_FAMILY_PLAN.md – Produktfamilien-Globalplan (über Produktgrenzen hinaus, HX470-Migration, Risiko-Trade-offs)

Verwandte Projekte

Brain-Produktfamilie: BrainMem (Memory-Engine) · BrainHub (dieses Repository) · BrainBridge (Collaboration-Gateway)

相关项目

Brain-Produktfamilie: BrainMem(记忆引擎)· BrainHub(本仓库)· BrainBridge(协作网关)

test input

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