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: MCPHub

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

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)