上下文保险库
克劳德的持久记忆层。
与克劳德的每一次谈话都是新的开始。Context Vault解决了这个问题。将决策、模式和知识保存到跨会话和项目的可搜索范围中。
问题
- 你反复解释同一个项目背景
- 过去对话中做出的决定被遗忘了
- “维护文档文件”是手动摩擦
- 在项目之间切换意味着重建上下文
解决方案
Context Vault是一个MCP服务器，为Claude提供持久内存：
- 自然保存 -“记住这个模式以备后用”
- 按范围组织 -每个项目、每个主题或个人知识
- 搜索所有内容 -在所有已保存的上下文中进行全文搜索
- 按需加载 -开始一个新的聊天，加载你的范围，从你停止的地方继续
- 适用于所有地方 -任何MCP客户端（克劳德代码、克劳德桌面、定制代理）
快速开始
git clone https://github.com/Dunya-8a/ClaudeContextVault.git
cd ClaudeContextVault
bun install && bun run build添加 .mcp.json 对于您的项目（已包含），重新启动Claude Code。
运作原理
1.工作时保存上下文
"Remember that we're using JWT for auth, not sessions"
"Save this API pattern to my project scope"
"Add this error handling snippet for later"2.需要时搜索
"Search my project for authentication decisions"
"What patterns have I saved about error handling?"3.在新聊天中加载上下文
"Load my Backend API scope"
"What do you know about this project?"4.跨项目共享
"Search all my scopes for database patterns"
"Import my TypeScript patterns into this project"用例
项目记忆 保存体系结构决策、API设计和基本原理。当你几个月后回到一个项目时，背景就在那里。
个人模式库 构建一组你喜欢的方法：错误处理、测试模式、代码风格。适用于所有项目。
学习与研究 在学习过程中保存见解、代码示例和链接。搜索并在相关时重新显示它们。
团队知识 （通过捆绑） 将范围导出为 .vault 捆。与队友分享或在机器之间转移。
工具参考（13个工具）
| 工具 | 说明 |
|---|---|
list_scopes | 列出所有包含项目计数的范围 |
create_scope | 创建新范围 |
get_scope | 使用项目获取范围（分页） |
update_scope | 更新作用域名称、描述或标签 |
delete_scope | 删除范围和所有项目 |
add_item | 添加注释/片段/链接/文件 |
update_item | 更新项目标题、内容、标签等。 |
delete_item | 删除项目 |
search_scope | 范围内的全文搜索 |
search_all | 在所有范围内进行全文搜索 |
summarize_scope | 获取摘要内容 |
export_scope | 导出为.vault捆绑包 |
import_scope | 从.vault捆绑包导入 |
项目类型
- 笔记 -自由形式的降价（决策、文件、想法）
- 片段 -带有可选语言元数据的代码
- 链接 -带有描述的URL
- 文件 -本地文件内容
内容支持完全降价，没有大小限制。
配置
环境变量（设置于 .mcp.json):
| 变量 | 默认值 | 描述 |
|---|---|---|
VAULT_DIRECTORY | 适用于操作系统的应用程序数据文件夹 | 数据存储位置 |
LOG_LEVEL | info | 日志记录级别（调试、信息、警告、错误） |
建筑
┌─────────────────────────────────────────────────────────┐
│ Claude Code / Desktop │
│ (MCP Client) │
└─────────────────────────┬───────────────────────────────┘
│ stdio
┌─────────────────────────▼───────────────────────────────┐
│ Context Vault Server │
│ (MCP Server, Node.js) │
├─────────────────────────────────────────────────────────┤
│ Tools (13) │ Services │
│ - list_scopes │ - ScopeService │
│ - create_scope │ - ItemService │
│ - add_item │ - SearchService │
│ - search_all │ - BundleService │
│ - export_scope │ │
│ - ... │ │
├─────────────────────────────────────────────────────────┤
│ SQLite + FTS5 │
│ (Full-text search, BM25 ranking) │
└─────────────────────────────────────────────────────────┘堆栈：
- 运行时间： Node.js 20+
- 语言： TypeScript
- 数据库： SQLite通过better-squarite3
- 搜索： FTS5与BM25排名
- 协议： MCP（模型上下文协议）
- 验证： Zod模式
数据
所有数据都存储在本地：
- 数据库：
$VAULT_DIRECTORY/vault.db（带FTS5的SQLite） - 捆：
$VAULT_DIRECTORY/bundles/（gzip压缩的JSON）
发展
bun run build # Build
bun run test # Run 40 tests
bun run typecheck # Type check“记住这一点”自动检测
Context Vault包括说明(.claude/CLAUDE.md)实现自然储蓄：
"Remember that we're using PostgreSQL for this project"
"Save this error handling pattern for later"
"Keep this API design decision"克劳德将自动检测保存意图并使用保险库。它还将主动建议保存重要决策。
关于基于钩子的显式检测，请参见 hooks/remember-this.md.
路线图
- \[x\] “记住这一点”自动检测
- \[\]用于自动加载上下文的MCP资源
- \[\]用于保存web内容的浏览器扩展
- \[\]嵌入语义搜索
许可证
麻省理工学院