MemTether · 带可验证证据链的跨客户端 AI Agent 记忆中枢 Skill 技能

技能简介

MemTether 是一款为多 AI 客户端打造的共享记忆中枢，定位为「The AI Memory Court」——所有写入的事实都附带可验证证据链：谁写的、何时生效、被哪条旧记忆替代、哪些冲突由谁裁决、附上可浏览器验证的防篡改哈希链。这解决了当下 AI Agent 的核心痛点：今天 Claude 记住的事，明天 Cursor 就忘了，或者每个客户端各自存一份互相对不上。它以本地 HTTP API（默认 8820 端口）+ 可选云端同步的形式部署。

核心能力

• 统一记忆存储：单一后端被任意 MCP / OpenAI / Anthropic 客户端共同读写，避免「每客户端一份记忆」
• 证据链（Evidence Chain）：每条事实附带 writer / created_at / supersedes / adjudicated_by 四元组，全链路可追溯
• 防篡改哈希链：每条记录与其前一条的 SHA-256 哈希一同存储，浏览器即可验证一致性，无需代码
• 12 个 HTTP 端点：覆盖写入 / 检索 / 修正 / 退役 / 时间线 / 价值评分 / 看板等全流程
• 冲突裁决工作流：当多条事实相互矛盾时进入「法院」模式，由人或更高权限 Agent 裁决
• REST + MCP 双接口：既能被任何 HTTP 客户端直接调，也能通过 MCP 工具被 Claude 等 Agent 调用
• 记忆评分（qvalue）：内置「该记忆有多值得保留」评分，自动淘汰低价值事实
• 可视化 Dashboard：内置 /dashboard 端点展示记忆分布、热度、冲突待办

安装配置

• 通过 pip install memtether 安装（需 Python ≥ 3.10，当前为 0.1.0a73 alpha 版）
• 运行 memtether init 在当前目录初始化 SQLite + 哈希链文件
• 启动服务：memtether serve --host 0.0.0.0 --port 8820，默认绑定 8820 端口
• 在 MCP 客户端配置中添加 MemTether 作为 MCP 服务器：

  {"mcpServers": {"memtether": {"command": "memtether-mcp", "args": ["--endpoint", "http://localhost:8820"]}}}

• 可选：把 memtether.db 挂载到云端对象存储（S3 / OSS）做多设备同步

使用步骤

1. 用 pip install memtether 安装包，运行 memtether --help 查看命令清单
2. memtether init 初始化本地数据文件；过程中会生成一对密钥用于证据链签名
3. memtether serve 启动 HTTP API（默认 8820 端口）；用 curl http://localhost:8820/health 验证
4. 通过 POST /remember 写入一条记忆（带 content / source / confidence 字段）
5. 通过 GET /search?q=... 检索；返回结果会附带证据链（写入者、时间、来源、哈希）
6. 出现冲突时调用 POST /correct 提交修正，旧记忆自动标记 superseded 并不删除（可审计）
7. 在浏览器打开 /dashboard 查看记忆分布、冲突待办与最近活动
8. 接入 Claude / Cursor：在 MCP 配置里加 memtether，Agent 即可直接用 remember / search / correct 工具

适用场景

• 同时使用 Claude / Cursor / Cline / Aider 等多款 AI 工具的开发者，记忆不再碎片化
• 团队共享同一个 AI 知识库（项目约定 / 客户画像 / 产品术语）且需要追溯来源
• 金融 / 法律 / 医疗 AI 助手场景，对记忆可审计、可解释有硬性合规要求
• 研究机构跨多轮实验记录「模型学到的关键事实」并保留原始证据
• 长会话 Agent（co-pilot / 个人助理）需要跨会话保持上下文的私部署场景
• 调试多 Agent 系统时，用 MemTether 做统一日志与对齐层

适用人群

在多 AI 客户端之间切换的重度用户、对 AI 输出可解释性有合规需求的行业（金融 / 医疗 / 法律）、构建长会话 Agent 系统的工程师，以及不愿把记忆交给闭源 SaaS 的本地化偏好者。

工作原理

MemTether 把每条记忆建模为「事件 + 证据」二元组：事件是写入内容，证据是 writer / 时间 / 来源 / 签名。每个事件写入时计算 hash = sha256(prev_hash + event_payload + signature)，形成单向链。客户端通过 REST 或 MCP 调用 API，每次读写都附带证据链；冲突解决走显式裁决（不静默覆盖）。底层用 SQLite 做结构化存储、JSONL 文件追加哈希链，兼顾可移植性与可验证性。

官方链接

• PyPI: https://pypi.org/project/memtether/
• GitHub: https://github.com/MemTether/MemTether
• Issues: https://github.com/MemTether/MemTether/issues
• License: Apache-2.0