Skip to main content
Glama

BrainHub — унифицированный веб-фронтенд + облачное хранилище + MCP-шлюз + операционный агент

Основная точка входа для личного использования семейства продуктов Brain: один процесс FastAPI агрегирует все панели (база знаний / поиск / облачное хранилище / канбан / память / статус агента / журналы операций) и предоставляет наружу единый MCP-шлюз; встроенный операционный агент автоматически поддерживает базу знаний и память.

Введение

BrainHub — точка входа в семейство продуктов Brain, собирающая все возможности продукта в единый управляемый интерфейс и набор API:

  • Веб-панель: Jinja2 + HTMX без сборки фронтенда — просмотр базы знаний / семантический поиск / CRUD облачного хранилища / конечный автомат задач канбана / память / статус агента / журналы операций

  • JSON API v1: /api/v1/* для вызова из React-фронтенда настольного приложения

  • MCP-шлюз: агрегирует 12 инструментов — собственные инструменты BrainHub + инструменты поиска BrainMem; любой агент подключается только к этой точке входа

  • Операционный агент: планировщик APScheduler: архивирование / перестроение индекса / извлечение памяти / проверка здоровья — без внешней оркестрации

  • Облачное хранилище — просмотр файлов BRAIN_ROOT, загрузка и скачивание, ленивая генерация миниатюр, блокировка выхода за границы и чувствительных путей

  • Канбан — конечный автомат проектов/задач (todo → doing → blocked → done, строгие переходы)

  • Интеграция совместной работы — через именованный канал передаёт send_matrix_msg демону BrainBridge, фронтенд через WS в реальном времени получает сообщения Matrix и статус агента

  • Монтирование настольного приложения с того же источника — /app монтирует артефакты сборки brainhub-desktop, тот же источник без CORS

Related MCP server: MCPHub

Архитектура

Каталог

Назначение

web/

Приложение FastAPI + шаблоны Jinja2 + WS; routes/api.py — JSON API v1 для настольного приложения

storage/

CRUD для файлов + миниатюры, архивирование write_note, лениво загружаемый Store для общей memory.db

projects/

Модель конечного автомата проектов/задач

ops/

Операционный агент: извлечение памяти, интерфейс OpsAgent, планировщик APScheduler

pipe/

Клиент именованного канала (связь с BrainBridge, конверт согласован с протокольной конституцией §3)

mcp.py

Шлюз fastmcp: собственные инструменты + пересылка инструментов BrainMem

cli.py

brainhub start / stop / status + подкоманда ops

Быстрый старт

# 安装(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 / конверт Matrix

  • ../brainmem/PRODUCT_FAMILY_PLAN.md — глобальный план семейства продуктов (границы между продуктами, миграция HX470, компромиссы по рискам)

Связанные проекты

Семейство продуктов Brain: BrainMem (движок памяти) · BrainHub (этот репозиторий) · BrainBridge (шлюз совместной работы)

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