HiveMemory MCP Server V5.0 全量交付
日期: 2026-03-17
参与者: William + Coco
状态: ✅ Phase 1-9 全部完成（31个工具）
交付成果
31个MCP工具（9个Phase）
| Phase |
工具 |
功能 |
状态 |
| 1 |
hive_search |
统一搜索（文件+话题+知识图谱） |
✅ |
| 1 |
hive_remember |
自动分类写入（决策/教训/洞察/事实） |
✅ |
| 1 |
hive_file_search |
16个工作区深度grep |
✅ |
| 1 |
hive_navigate |
多米诺链路导航 |
✅ |
| 1 |
hive_stats |
记忆系统统计 |
✅ |
| 2 |
hive_flush |
一键Full Flush 6步 |
✅ |
| 2 |
hive_save_topic |
话题保存+INDEX.md |
✅ |
| 2 |
hive_collect |
成果归集（调用daily_output_collector） |
✅ |
| 2 |
hive_context |
任务上下文构建（registry+话题+文件+图谱） |
✅ |
| 3 |
hive_sync |
全量同步状态报告（quick/standard/full） |
✅ |
| 3 |
hive_drift_scan |
L0漂移扫描（调用l0_drift_scanner.py） |
✅ |
| 3 |
hive_dedup |
记忆去重（话题+知识图谱） |
✅ |
| 4 |
hive_harvest |
任务收割（文本→actionable→task_registry） |
✅ |
| 4 |
hive_recall |
话题回忆（搜索+全文+pending提醒） |
✅ |
| 4 |
hive_watch |
文件监视（状态/变更列表/手动索引） |
✅ |
| 5 |
hive_graph_query |
知识图谱直接查询（993MB knowledge_graph.db） |
✅ |
| 5 |
hive_lightrag |
LightRAG图谱检索（4.3GB 实体/关系/文本块） |
✅ |
| 5 |
hive_doc_search |
文档FTS5全文检索（memory_search.db） |
✅ |
| 6 |
hive_consolidate |
记忆合并压缩（过期条目/经验去重/日志归档） |
✅ |
| 6 |
hive_decay |
Weibull记忆衰减评分（时间+频率+重要性） |
✅ |
| 6 |
hive_validate |
记忆完整性校验（SHA-256/L0/注入检测/DB可读性） |
✅ |
| 6 |
hive_compress |
上下文三层压缩（L1微/L2中/L3强） |
✅ |
| 6 |
hive_ingest |
日记/日志语义导入到知识图谱 |
✅ |
| 7 |
hive_inject |
任务上下文自动注入包（依赖+日记+话题+KG） |
✅ |
| 7 |
hive_snapshot |
文件变更快照对比（git diff式） |
✅ |
| 7 |
hive_dual_sync |
5源混合检索（HiveMemory+KG+DocSearch+Grep+话题） |
✅ |
| 8 |
hive_code_graph |
代码图谱查询（AST/依赖/调用关系） |
✅ |
| 9 |
hive_rebirth |
一键重生协议（Phase 1-3状态检查+摘要） |
✅ |
| 9 |
hive_version_check |
版本继承检查（查找前版本+结构对比） |
✅ |
| 9 |
hive_micro_flush |
Micro Flush（一行写入MEMORY.md L2+KG） |
✅ |
| 9 |
hive_reindex |
话题索引重建（扫描topics/→重生成INDEX.md） |
✅ |
基础设施
- 服务端口: 8421（HTTP MCP streamable-http）
- 代码位置:
09-虚拟办公区系统/hivememory_mcp/server.py（~2500行）
- 自启动: launchd
com.hivecosm.hivememory-mcp
- MCP注册:
~/.claude.json 全局+项目级
- 实测验证: 31工具全部加载成功
五组工具能力矩阵
| 组别 |
工具 |
核心能力 |
| 写入组(5) |
remember / flush / save_topic / harvest / micro_flush |
自动路由写入 / 6步Flush / 话题保存 / 任务收割 / 即时记录 |
| 检索组(8) |
search / file_search / navigate / recall / context / graph_query / lightrag / doc_search / dual_sync |
5源混合搜索 / 993MB知识图谱 / 4.3GB LightRAG / FTS5 / 多米诺导航 |
| 生命周期(5) |
consolidate / decay / validate / compress / ingest |
合并压缩 / Weibull衰减 / SHA-256校验 / 三层压缩 / 语义导入 |
| 维护组(6) |
sync / drift_scan / dedup / collect / watch / snapshot / reindex |
17层同步 / 漂移扫描 / 去重 / 归集 / 文件监视 / 快照 / 索引重建 |
| 协议组(3) |
rebirth / version_check / inject |
一键重生 / 版本继承 / 上下文注入 |
| 智能组(1) |
code_graph |
AST代码图谱查询 |
数据源接入矩阵
| 数据源 |
大小 |
接入工具 |
状态 |
| hive_memory.db |
61MB |
search/remember/dedup/watch/ingest |
✅ |
| knowledge_graph.db |
993MB |
graph_query/dual_sync |
✅ |
| memory_search.db |
11MB |
doc_search/dual_sync |
✅ |
| LightRAG Store |
4.3GB |
lightrag |
✅ |
| code_graph.json |
5.5MB |
code_graph |
✅ |
| 全部5个数据源 |
5.4GB |
— |
100%接入 |
William的四点纠正（P0认知校准）
此次工作源于William发现Coco忘记公司数字资产，追溯到记忆体系根因：
1. "无状态论"是错误的 → 已有永生引擎+文档体系
2. "不知道不知道"是行为惰性 → 导航路径存在但没执行
3. 压缩问题已有解决方案 → 强制文档化+日记
4. 应该MCP化所有已有机制 → HiveMemory MCP Server
穷尽封装覆盖率
| 维度 |
总量 |
V2.0(12工具) |
V5.0(31工具) |
| 设计工具 |
16个 |
81% |
100% |
| Python文件(28) |
28个 |
~50% |
~90% |
| 行为协议(8) |
8个 |
~56% |
~88% |
| 数据库(5) |
5个 |
20% |
100% |
| Skill(5) |
5个 |
60% |
80% |
版本历程
| 版本 |
工具数 |
代码行 |
里程碑 |
| V1.0 |
5 |
~400 |
Phase 1: 搜索+写入+导航 |
| V2.0 |
12 |
~900 |
Phase 2+3: Flush+话题+归集+同步+扫描 |
| V3.0 |
15 |
~1500 |
Phase 4: 收割+回忆+监视 |
| V5.0 |
31 |
~2500 |
Phase 5-9: 全量封装完成 |
| V6.0 |
36 |
~2800 |
Phase 10-12: 自动化+产品化+商业化研究 |
Phase 10: 自动化基础设施 ✅
| 组件 |
文件 |
功能 |
launchd服务 |
状态 |
| Watchdog |
watchdog_daemon.py |
16个工作区文件变更实时监视→自动索引KG |
com.hivecosm.hivememory-watchdog (KeepAlive) |
✅ 运行中 |
| Heartbeat |
heartbeat_daemon.py |
5DB+6文件+2服务+磁盘 每5分钟检查 |
com.hivecosm.hivememory-heartbeat (KeepAlive) |
✅ 运行中 |
| 轻同步 |
scheduled_sync.py light |
漂移扫描quick模式 |
com.hivecosm.hivememory-sync-light (每2h) |
✅ 已加载 |
| 每日同步 |
scheduled_sync.py daily |
全量漂移+成果归集+L2检查+话题索引 |
com.hivecosm.hivememory-sync-daily (23:00) |
✅ 已加载 |
| 每周深扫 |
scheduled_sync.py deep |
339+文件deep扫+DB完整性 |
com.hivecosm.hivememory-sync-weekly (周日03:00) |
✅ 已加载 |
Phase 11: 产品化基础 ✅
| 组件 |
文件 |
功能 |
状态 |
| pip包 |
pyproject.toml + __init__.py + __main__.py |
pip install hivememory / hivememory serve\|health\|sync\|watch\|dashboard\|auth |
✅ wheel已构建(47KB) |
| Dashboard |
dashboard.py (端口8422) |
健康总览+36工具列表+同步历史+Watchdog事件+快速操作+认证集成 |
✅ launchd运行中 |
| API认证 |
auth.py + api_keys.yaml |
HMAC-SHA256签名+Bearer/X-API-Key+权限分级(admin/write/read)+速率限制+审计日志 |
✅ 本地admin key已生成 |
| README |
README.md |
包说明文档 |
✅ |
Phase 12: 覆盖率补齐+认证集成+商业化 ✅
| 组件 |
功能 |
状态 |
| 5个新MCP工具 |
hive_lightrag_index / hive_external_kb / hive_shared_memory / hive_pre_compress / hive_experience |
✅ 36工具验证通过 |
| Dashboard认证 |
_apply_auth中间件，read/admin分级，懒加载auth模块 |
✅ 已集成 |
| TOOLS_REGISTRY |
更新至10 Phase 36工具，HTML标题+版本号同步更新至V6.0.0 |
✅ |
| 商业化研究V1.0 |
竞品对标(Mem0/Zep/Nowledge/LangMem)+定价方案(A/B/C)+技术就绪度+风险 |
✅ 文档已交付 |
server.py版本: V5.0.0 → V6.0.0（~2800行，36工具）
后续方向（Phase 13+）
- [ ] Docker化（客户部署标准化）
- [ ] 多租户隔离（每客户独立数据库实例）
- [ ] PyPI发布（
pip install hivememory公网可用）
- [ ] 使用计量（工具调用次数/记忆数量计费）
- [ ] Community版开源（5个基础工具免费）
- [ ] MCP Server认证集成（server.py工具级别权限控制）
商业化研究核心结论
- 竞品：Mem0($19-249/月,$24M融资) / Zep($25-475/月) / 无人做多Agent组织记忆
- 差异化：唯一多Agent组织记忆+36工具+5.4GB五源+六层认知编码+自动化运维
- 推荐方案C混合模式：开源引流(5工具) + SaaS验证(¥199-4999/月) + 服务锁定(¥2K/月增值)
- 详细文档：
04-项目档案/数字员工商业化/hivememory-commercialization-research-v1.md
Phase 12.5: 记忆系统碎片化修复 ✅（William P0批评驱动）
问题根因：William发现记忆系统存在严重碎片化——全量同步/save-topic/Memory Flush写文件但内容不入数据库，导致搜索检索不到已有信息。
William核心批评："永远都是我在发现问题，你来负责修改。能不能形成机制，你来发现问题并自主修改？"
| 修复项 |
内容 |
状态 |
| watchdog内容索引 |
文件变更时读取内容摘要写入KG+hive_memory.db（之前只记metadata） |
✅ |
| watchdog schema修复 |
匹配生产schema file_nodes(node_id,...,last_scan_at) |
✅ |
| hive_search Nowledge提示 |
搜索结果末尾提示同时查询Nowledge Mem |
✅ |
| hive_save_topic写入KG |
server.py新增_write_to_knowledge_graph调用 |
✅ |
| /save-topic SKILL.md |
新增Step 5.5：话题内容写入两个数据库 |
✅ |
| hive_self_check(#37) |
7项自检+fix模式自动修复（话题同步/INDEX一致/DB健康等） |
✅ |
| scheduled_sync增强 |
每日同步新增content_backfill+self_check |
✅ |
| 对话心跳协议 |
CLAUDE.md新增：每5轮静默存档到hive_memory.db |
✅ |
| schema修复 |
scheduled_sync.py旧列名scan_date→last_scan_at |
✅ |
| 服务重启 |
watchdog+MCP server已重启加载新代码 |
✅ |
server.py版本: V6.0.0（37工具，含新增hive_self_check）