编程代理上下文检索MCP服务

Mooncite 是一款面向编程代理的本地历史上下文检索服务,通过 MCP 协议从 Pi、OMP、Claude Code、Codex 和 ChatGPT 的本地记录中召回上下文并核验引用来源,使代理无需用户重新解释即可恢复过往工作现场。

  • by WhenMoon-afk
  • TypeScript
  • 本地部署
  • 69 星标
  • 更新于
在 GitHub 查看 WhenMoon-afk/claude-memory-mcp

使用说明

Mooncite

Mooncite lets coding agents recover past context without asking you to explain it again. It searches authorized Pi, OMP, Claude Code, Codex, and ChatGPT history stored on this machine. Before an agent relies on a result, mooncite_inspect checks the citation against the original file. That confirms where the text came from. It does not prove the text is still true.

Mooncite was formerly Claude Memory MCP. The repository keeps its old claude-memory-mcp URL.

flowchart LR
    H[Human] -->|installs| M[Mooncite]
    A[Coding agent<br/>Pi, OMP, Codex, Claude Code] -->|recall and inspect| M
    M -->|reads only| S[Local history<br/>Pi, OMP, Claude Code, Codex, ChatGPT]
    M <--> I[(Search index)]
    M -->|cited context| A

Install

Mooncite requires Linux with procfs, Node.js 24 or newer, npm, and access to GitHub. Packaged local embeddings are Linux x64 only. Other Linux architectures still install and search lexically.

npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.7 install

Tagged v4.0.7 is the current stable release. After installation, check the launcher. Then fully restart or reload each client whose registration is exact:

"$HOME/.local/bin/mooncite" status

The installer configures available Pi, OMP, Codex, and Claude Code clients. ChatGPT is a source, not a client. See operations for source setup, ChatGPT exports, removal commands, and quick fixes.

First search

Recall runs inside a configured client. It is not a shell command. Give the agent one distinctive phrase:

Call mooncite_recall with "". Start without a scope. If it returns a candidate, inspect that candidate's evidence_id with mooncite_inspect. Treat verified as proof that the cited text still matches its source file. It does not prove the text is true.

Mooncite exposes exactly three tools:

  • mooncite_recall searches bounded local evidence. An unquoted query of at least two terms may add local embedding matches after no strong lexical hit.
  • mooncite_inspect checks a locator against current source bytes.
  • mooncite_status reports coverage and health without transcript text.

Read next

  • Agent workflow tells an agent when to recall, narrow, inspect, and recover.
  • MCP protocol lists exact tool inputs and outcomes.
  • Operations covers install, source configuration, status, rebuild, disable, uninstall, and purge.
  • Architecture explains the engine, index, and clients.
  • Security explains source containment, local data handling, and deletion limits.

Mooncite never writes source history. Text returned through MCP becomes model context and is subject to that model provider's data handling.