代理内存存储
MCP服务器在Claude Code会话中提供持久的键值存储。
特性
- 持久存储 -记忆在上下文截断和会话结束后仍然存在
- 全文搜索 -FTS5支持跨键、值和标签的搜索
- 语义搜索 -基于意义检索的可选嵌入
- 命名空间范围 -组织方式
global,project:{name},或session:{id} - 重要性评分 -按1-10个重要性级别对记忆进行优先级排序
- TTL支持 -临时存储器自动过期
- 多机接入 -Tailscale安全HTTP传输
安装
服务器(数据库所在地)
git clone https://github.com/evansenter/agent-memory-store.git
cd agent-memory-store
make install-server # systemd + MCP config + tailscale serve客户端(连接到远程服务器)
make install-client REMOTE_URL=https://your-host.ts.net/agent-memory-store/mcp启用语义搜索(可选)
uv sync --extra embeddings
# or: pip install agent-memory-store[embeddings]安装 sentence-transformers 随着 all-MiniLM-L6-v2 (~80MB)。
快速开始
存储内存
memory store "api-pattern" "Use Bearer tokens for Foo API" --tags api,auth按密钥调用
memory recall --key "api-pattern"搜索记忆
memory recall --search "authentication"语义搜索
memory recall --search "how does auth work" --mode semantic列出最近的回忆
memory list --since-days 7MCP工具
| 工具 | 目的 |
|---|---|
memory_store | 存储键、值、命名空间、标签、重要性、ttl |
memory_recall | 按关键字或搜索检索(fts/语义) |
memory_forget | 按键删除 |
memory_list | 带过滤器的列表 |
memory_query | 结构化查询(正则表达式、日期、重要性) |
memory_explore | 查询前获取统计数据 |
memory_search_weighted | 近期x重要性x相关性评分 |
memory_aggregate | 按命名空间/标签/重要性/日期分组 |
看 guide.md 或通过MCP资源访问 agent-memory-store://guide.
建筑
Claude Code Session
|
v
MCP Protocol (stdio or HTTP/SSE)
|
v
agent-memory-store
├── SQLite + FTS5 (full-text search)
└── sqlite-vec (semantic embeddings, optional)数据位置: ~/.claude/contrib/agent-memory-store/memories.db
相关项目
许可证
麻省理工学院
