BrainHub
BrainHub — 统一 Web 前端 + 网盘 + MCP 网关 + 运维 agent
Brain 产品族的自用主入口:一个 FastAPI 单进程聚合所有面板(知识库 / 搜索 / 网盘 / 看板 / 记忆 / agent 状态 / 运维日志),对外提供单一 MCP 网关,内置运维 agent 自动维护知识库与记忆。
简介
BrainHub 是 Brain 产品族的使用入口,负责把产品族全部能力收拢到一个可操作的界面与一套 API 里:
Web 面板:Jinja2 + HTMX 零前端构建,知识库浏览 / 语义搜索 / 网盘 CRUD / 看板任务状态机 / 记忆 / agent 状态 / 运维日志
JSON API v1:
/api/v1/*供桌面端 React 前端调用MCP 网关:聚合 BrainHub 自有工具 + BrainMem 检索工具共 12 个,任何 agent 只连这一个入口
运维 agent:定时归档、索引重建、记忆提取、健康检查
自用期一个 brainhub start 把主进程全部拉起:import brainmem 当检索后端、拉起 brain-bridge 子进程,对外像一个软件。
Related MCP server: stac2026
特性
🖥️ 统一面板 — 7 类页面聚合在一个服务,HTMX 局部刷新 + Alpine 轻交互,无需前端构建链
🔌 单一 MCP 入口 —
write_note/read_file/list_files/ 项目状态机 /health_check/send_matrix_msg+ 转发 BrainMem 检索工具🤖 运维 agent — APScheduler 定时:归档 / 索引重建 / 记忆提取 / 健康检查,无需外部编排
📁 网盘 — BRAIN_ROOT 文件浏览、上传下载、缩略图懒生成、越界与敏感路径拦截
📋 看板 — 项目/任务状态机(todo → doing → blocked → done,严格流转)
🔗 协作对接 — 经命名管道把
send_matrix_msg转发给 BrainBridge daemon,前端 WS 实时收 Matrix 消息与 agent 状态💻 桌面端同源挂载 —
/app挂载 brainhub-desktop 构建产物,同源免 CORS
架构组成
目录 | 职责 |
| FastAPI 应用 + Jinja2 模板 + WS; |
| 文件 CRUD + 缩略图、 |
| 项目/任务状态机模型 |
| 运维 agent:记忆提取、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(协作网关)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP gateway and cloud hosting for MCP servers, agents and apps like RAG, managed from your agent.
An MCP gateway for teams deploying AI tools at scale to employee-facing and headless agents.
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.-
- 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.35Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA 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.2MIT