recall-vault-mcp

跨会话、跨项目的本地记忆 MCP server。flexsearch BM25 + TF-IDF 三路混合检索，双时钟事实管理，自动 Hook 链路。

为什么需要 recall-vault-mcp？

快速安装

方式 1：npx 零安装（推荐）

在你的 IDE MCP 配置里加：

{
  "mcpServers": {
    "recall-vault": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "recall-vault-mcp"]
    }
  }
}

方式 2：全局安装

npm i -g recall-vault-mcp

{
  "mcpServers": {
    "recall-vault": {
      "type": "stdio",
      "command": "recall-vault-mcp"
    }
  }
}

方式 3：Smithery 一行多 client

npx @smithery/cli install recall-vault-mcp --client codebuddy --scope user
npx @smithery/cli install recall-vault-mcp --client claude --scope user
npx @smithery/cli install recall-vault-mcp --client codex --scope user
npx @smithery/cli install recall-vault-mcp --client trae --scope user

安装全局 Skill

npx recall-vault-mcp install-skills

自动复制 SKILL.md 到 ~/.trae/skills/、~/.codebuddy/skills/、~/.claude/skills/ 等 7 个 IDE 全局目录。

支持的 IDE

核心功能

1. 三路混合检索 → RRF 融合

flexsearch BM25 + TF-IDF + legacy countOccurrences → RRF(k=60)
  → priority × reviewed × recencyScore(双曲衰减) → 最终排序

2. 双时钟事实管理

---
valid_from: 2026-10-28T10:00:00Z
valid_to: null                      # null = 当前有效
supersedes: mem_phase1_fts_engine   # 我取代了谁
superseded_by: null                 # 谁取代了我（replaces 自动填）
priority: 3                         # 1=低 2=正常 3=踩坑经验
tags: [fts, flexsearch, windows]
---

remember replaces=<old_id> 自动关闭旧记忆（valid_to=now + superseded_by 填新 id）。

3. 自动 Hook 链路

4. WrapHandler Eyes 层

所有 MCP tool 自动 capture：

{ "ts": "...", "tool": "remember", "args": {"content": "前100字符..."}, "status": "ok", "ms": 23 }

存到 ~/.recall-vault/journal/*.jsonl，backlog ≥ 50 时 recall 返回提醒。

10 个 MCP 工具

Vault 结构

~/.recall-vault/
├── projects/                    # 每个项目一个目录
│   ├── recall-vault/            # 自动从 cwd basename 推断
│   │   ├── semantic/            # 项目级决策/约定
│   │   │   └── mem_phase1_fts_engine.md
│   │   └── episodic/            # 会话级摘要
│   └── some-other-project/
├── shared/                      # 跨项目通用记忆
│   └── semantic/
│       └── mem_npm_publish_flow.md
└── journal/                     # Eyes 自动 capture
    └── 2026-10-29.jsonl

本地开发

git clone https://github.com/robinz1001/recall-vault-mcp.git
cd recall-vault-mcp
npm install
npm run build

# 测试
node scripts/test-batch1.mjs   # 15 tests
node scripts/test-batch2.mjs   # 12 tests
node scripts/test-phase2.mjs   # 14 tests

# CLI
node bin/recall-vault-mcp.mjs doctor
node bin/recall-vault-mcp.mcp list

技术栈

路线图

许可

MIT © robinz1001