MCP Ltm

mcp-ltm：LLM的长期记忆

为AI助手提供持久长期内存的MCP服务器。内存存储为可浏览的markdown文件，带有SQLite索引，用于快速基于标签的检索。

特性

• 基于标签的检索：使用标签存储和查询内存，按重叠排序
• 人类可浏览：使用YAML frontmatter将内存存储为markdown文件
• 标签共现：根据相关标签一起出现的频率发现它们
• 内存链接：在相关记忆之间创建维基风格的链接
• 来源参考：使用基于源的路径管理将内存链接到外部文档
• 访问跟踪：跟踪何时以及多久访问一次内存进行修剪

安装

pip install -e .

配置

添加到您的Claude Code MCP设置中(~/.claude.json):

{
  "mcpServers": {
    "ltm": {
      "command": "mcp-ltm",
      "env": {
        "MCP_LTM_PATH": "/path/to/memories",
        "MCP_LTM_CONFIG": "/path/to/config.yaml"
      }
    }
  }
}

默认路径（如果未设置env变量）：

• 回忆： ~/.local/share/mcp-ltm/memories/
• 配置： ~/.local/share/mcp-ltm/config.yaml

工具

内存操作

• store_memory -使用标题、标签、摘要、内容、可选来源/链接创建内存
• query_memories -按标签搜索（按重叠排序），按required_tags筛选
• get_memory -按ID检索（更新访问统计信息）
• update_memory -修改现有内存
• 删除记忆 -删除内存
• get_sale_memories -寻找旧的、很少被访问的记忆进行修剪

标签操作

• 获取标签 -列出所有标签，包括使用次数和示例摘要
• 获取相关标签 -查找经常同时出现的标签（用于查询扩展）

原产地管理

• 列表_原产地 -显示已配置的源目录
• add_origin -注册来源（自动合约现有匹配来源）
• remove_origin -删除原点映射

起源：管理源路径

起源允许您使用短路径，如 myproject:docs/file.md 而不是完全的绝对路径。

配置文件 (~/.local/share/mcp-ltm/config.yaml):

origins:
  myproject: /home/user/projects/myproject
  notes: /home/user/notes

当使用源存储内存时：

• 与原点匹配的完整路径会自动收缩
• 检索时，路径将扩展回完整路径
• 使记忆便携且可读

存储格式

每个内存都是一个带有YAML frontmatter的markdown文件：

---
id: example-memory-title
title: Example Memory Title
tags: [python, debugging, testing]
summary: Brief description of what this memory contains.
source: myproject:docs/example.md
created_at: 2026-01-15T10:30:00Z
accessed_at: 2026-01-20T14:00:00Z
access_count: 3
links: [related-memory-id]
---

# Example Memory Title

Full content here. Can link to [other memories](related-memory-id.md).

SQLite索引(index.db)存储元数据以进行快速查询，但如果需要，可以从markdown文件重建。

标签约定

标签被规范化：小写，空格变为连字符，标点符号被去除（用于命名空间的冒号除外）。

建议前缀：

• type: -记忆类型（决策、洞察力、偏好、事实、参考）
• project: -项目名称
• topic: -主题领域

使用模式

纯粹的记忆

独立见解，无需外部参考：

store_memory(
    title="Python Dict Merge Operator",
    tags=["python", "syntax"],
    summary="Python 3.9+ supports d1 | d2 to merge dicts.",
    content="Use `d1 | d2` to merge dictionaries..."
)

参考记忆

指向详细外部文件的摘要：

store_memory(
    title="Project Architecture Overview",
    tags=["project:foo", "architecture"],
    summary="Key architectural decisions for the Foo project.",
    content="Main insight: use event sourcing for audit trail...",
    source="/path/to/architecture.md"
)

许可证

MIT许可证-请参阅 许可证 了解详情。