Skip to main content
Glama

BrainHub — frontend web unificado + disco en la nube + puerta de enlace MCP + agente de operaciones

Entrada principal de uso propio de la familia de productos Brain: un único proceso FastAPI agrega todos los paneles (base de conocimiento / búsqueda / disco en la nube / tablero / memoria / estado del agente / registros de operaciones), expone una única puerta de enlace MCP e incluye un agente de operaciones que mantiene automáticamente la base de conocimiento y la memoria.

Introducción

BrainHub es la puerta de entrada de la familia de productos Brain; se encarga de reunir todas las capacidades de la familia en una interfaz operable y en un conjunto de API:

  • Panel web: construcción sin compilación de frontend con Jinja2 + HTMX, navegación de base de conocimiento / búsqueda semántica / CRUD de disco en la nube / máquina de estados de tareas del tablero / memoria / estado del agente / registros de operaciones

  • API JSON v1: /api/v1/* para que lo consuma el frontend React de escritorio

  • Puerta de enlace MCP: agrega las herramientas propias de BrainHub + las herramientas de recuperación de BrainMem, 12 en total; cualquier agente se conecta solo a esta entrada

  • Agente de operaciones: archivado programado, reconstrucción de índices, extracción de memoria, comprobaciones de salud

En la etapa de uso propio, un solo brainhub start levanta todo el proceso principal: importa brainmem como backend de recuperación, inicia el subproceso brain-bridge y, hacia el exterior, parece un software unificado.

Related MCP server: stac2026

Características

  • 🖥️ Panel unificado — 7 tipos de páginas agregados en un solo servicio, refresco parcial con HTMX + interacción ligera con Alpine, sin compilación de frontend

  • 🔌 Entrada MCP única — write_note / read_file / list_files / máquina de estados de proyectos / health_check / send_matrix_msg + reenvío de las herramientas de recuperación de BrainMem

  • 🤖 Agente de operaciones — programación con APScheduler: archivado / reconstrucción de índices / extracción de memoria / comprobaciones de salud, sin orquestación externa

  • 📁 Disco en la nube — exploración de archivos en BRAIN_ROOT, carga y descarga, generación diferida de miniaturas, bloqueo de rutas fuera de límites y sensibles

  • 📋 Tablero — máquina de estados de proyectos/tareas (todo → doing → blocked → done, transición estricta)

  • 🔗 Integración de colaboración — reenvía send_matrix_msg al daemon de BrainBridge a través de una tubería con nombre; el frontend recibe en tiempo real por WS los mensajes de Matrix y el estado del agente

  • 💻 Montaje de mismo origen para el escritorio — /app monta los artefactos de compilación de brainhub-desktop, mismo origen sin CORS

Composición de la arquitectura

Directorio

Responsabilidad

web/

Aplicación FastAPI + plantillas Jinja2 + WS; routes/api.py es la API JSON v1 para el escritorio

storage/

CRUD de archivos + miniaturas, archivado con write_note, Store de carga diferida que comparte memory.db

projects/

Modelo de máquina de estados de proyectos/tareas

ops/

Agente de operaciones: extracción de memoria, interfaz OpsAgent, programación APScheduler

pipe/

Cliente de tubería con nombre (comunica con BrainBridge, envelope alineado con la constitución del protocolo §3)

mcp.py

Puerta de enlace fastmcp: herramientas propias + reenvío de herramientas de BrainMem

cli.py

brainhub start / stop / status + subcomando ops

Inicio rápido

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

Índice de documentación

  • PLAN.md — plan de implementación y progreso actual (aceptación de las Fases 1-3, panel, Cron de operaciones, herramientas MCP, dependencias)

  • docs/protocol-constitution.md — constitución del protocolo: firmas de herramientas MCP / esquema de memory.db / envelope de Matrix

  • ../brainmem/PRODUCT_FAMILY_PLAN.md — plan global de la familia de productos (límites entre productos, migración HX470, compensaciones de riesgos)

Proyectos relacionados

Familia de productos Brain: BrainMem (motor de memoria) · BrainHub (este repositorio) · BrainBridge (puerta de enlace de colaboración)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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.
      -
    • 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.
      35
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      2
      MIT