Mooncite 为本地编码代理提供有界、带引文支持的检索能力，可检索经授权的 Pi、OMP、Claude Code、Codex 和 ChatGPT 对话历史。检索返回确定性的证据定位符；verified 检查会在返回源窗口之前，将定位符与当前物理源字节进行比较。Mooncite 检索先前的上下文——它不决定该上下文意味着什么，也不决定它是否仍然具有权威性。
需要带 procfs 的 Linux、Node.js 24 或更高版本，以及 npm 命令。获取带标签的软件包还需要访问 GitHub。当 Mooncite 无法通过 Linux 文件描述符固定授权的源根目录时，它会失败关闭。
npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.5 install可选地单独验证已安装的启动器：
"$HOME/.local/bin/mooncite" status标记为 v4.0.5 的版本是当前稳定版，从 GitHub 分发，而非 npm 注册表。
要试用当前预发布版而不替换稳定标签：
npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.6-preview.1001.0 install全新安装会将稳定软件包放置在 $XDG_DATA_HOME/mooncite（默认 ~/.local/share/mooncite）下，在 $XDG_STATE_HOME/mooncite（默认 ~/.local/state/mooncite）下构建证据索引，并在 ~/.local/bin/mooncite 创建精确的启动器链接。它会为每个可验证的受支持客户端进行配置：
Pi：打包的瘦扩展
Oh My Pi (OMP)：带打包 .mcp.json 的链接包
Codex：本地 stdio MCP 注册
Claude Code：本地 stdio MCP 注册
安装结果会报告每项注册。仅当其值为 exact 时才使用某个客户端；不可用的客户端会被报告并保持原样。冲突的 mooncite 注册、无关的启动器命令或稳定安装路径上的不同软件包会被拒绝，而不会被覆盖。
每次安装或重新安装后，在使用 Mooncite 之前，请完全重启或重新加载每个已配置的客户端。已在运行的客户端或 MCP 子进程不保证能热重载，可能继续提供旧代码或旧状态。
如果您的 shell 报告 mooncite: command not found，说明安装程序未编辑您的 shell 启动文件。请使用上面显示的精确路径，或将启动器目录添加到 PATH：
export PATH="$HOME/.local/bin:$PATH"
mooncite statusPi 和 OMP 使用其标准会话根目录。可选的自动根目录为 ~/.claude/projects、~/.config/claude-sol/projects、~/.codex/sessions（或 $CODEX_HOME/sessions）和 ~/incoming/chatgpt-share-archive。显式的 source add 根目录会覆盖该来源的自动发现。使用 MOONCITE_AUTO_SOURCES=0 启动进程可禁用所有可选的自动根目录。ChatGPT 是一个来源（source origin），而非第五个客户端注册。
Related MCP server: Claude Memory MCP
检索是在已注册客户端内部使用的 MCP 工具，而非 mooncite recall shell 命令。在重启注册值为 exact 的客户端后，粘贴以下提示：
使用早期对话中的一句独特短语调用
mooncite_recall。阅读其outcome、conclusive、meaning、候选match、警告和next。如果返回候选，则将最佳候选的evidence_id传递给mooncite_inspect。将verified视为物理来源证明，而非真理或当前权威。如果检索结果为inconclusive或unavailable，请遵循其下一步操作，而不要声称证据不存在。
默认情况下，Mooncite 恰好暴露三个证据 MCP 工具：
mooncite_recall — 有界词汇搜索，具有明确的 matches、weak_leads、no_match、inconclusive、invalid_scope 和 unavailable 结果
mooncite_inspect — 根据当前物理字节验证证据 ID 或 URI，并返回有界的源窗口
mooncite_status — 报告就绪、降级或不可用的健康状态、按来源统计的源数量、刷新时间、分组错误和注册状态，不包含转录文本
检索会解释精确/短语/术语匹配、匹配和缺失的术语、摘录截断、重复折叠、递归输出抑制以及具体的下一步操作。从无范围开始。仅使用从候选复制的精确 project 或来源限定的 sessionId 来缩小范围。检索首先搜索当前投影，仅在未命中时执行一次有界的增量刷新；mooncite rebuild 仍然是显式的完整操作。
先使用检索，然后在依赖证据之前检查返回的 mooncite:<origin>:… 或 mooncite://<origin>/… 定位符。verified 检查意味着被引用的物理字节和身份与活动索引匹配；它并不确立所引用的声明是正确的或仍然具有权威性。来源为 pi、omp、claude-code、codex 和 chatgpt。
此预发布版还有一个独立的、默认关闭的学习记忆模式。mooncite memory enable 写入严格的所有者私有选择加入；在每个客户端重启后，它会有条件地添加 mooncite_memory_recall、mooncite_memory_inspect、mooncite_memory_write 和 mooncite_memory_delete。这些工具将带有显式引文支持的派生解释存储在 $XDG_STATE_HOME/mooncite/learned-memory.sqlite 中。它们绝不会将学习到的文本添加到源证据或一次性证据索引中。使用 mooncite memory disable 隐藏这些工具，同时保留学习状态，并使用 mooncite memory status 检查就绪状态。
mooncite status
mooncite rebuild
mooncite source listsource add 记录显式的本地覆盖，而不复制历史记录；source remove 仅移除该覆盖，因此可用的自动根目录可能会重新变为活动状态。
disable 仅移除记录为安装所拥有的客户端注册。uninstall 还会移除已识别的稳定软件包和精确启动器链接。两者都保留源历史、源授权、证据索引、学习记忆配置以及任何学习数据库。在任一命令后，完全重启或重新加载受影响的客户端，以便先前加载的工具停止运行。
purge --yes 单独删除仅被识别为 Mooncite 拥有的派生状态，包括证据和学习记忆 SQLite 文件，并拒绝未知条目。它保留源历史和两个配置文件。Mooncite 没有就地跨版本更新程序。有关源命令、学习记忆保留、保守的删除顺序、失败处理和版本变更，请参阅 operations。
ChatGPT 桌面应用使用与 ChatGPT 网页版相同的账户支持的对话服务；Mooncite 不会抓取应用缓存、浏览器 cookie 或凭据。在 ChatGPT 中请求受支持的数据导出，路径为 设置 → 数据控制 → 导出，将其解压到 ~/incoming/chatgpt-share-archive（或使用 source add chatgpt 注册解压后的目录），然后运行 mooncite rebuild。Mooncite 扫描 conversation.json、conversations.json 和编号的 conversations-N.json 文件；每个文件可能包含一个对话对象或一个顶层数组。
Mooncite 是本地且对每个源文件只读的。自动发现仅限于指定的标准根目录，并可通过 MOONCITE_AUTO_SOURCES=0 为进程禁用。检索返回有界摘录；只有 verified 检查包含经当前源验证的窗口。通过 MCP 工具发送的文本会成为模型上下文，随后受该模型提供商的数据处理政策约束。Mooncite 不会上传历史记录、请求 ChatGPT 导出或调用 SSH；远程历史记录必须首先复制或挂载到本地根目录中。
请参阅 architecture、protocol、operations 和 security。
This server cannot be deployed
An MCP memory server. One memory your agents share — across models, devices and apps.
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Cloud-hosted MCP server for durable AI memory
