Mnemoscope

io.github.toonight由 GitHub 账号 toonight 发布v0.2.0更新于 Oct 24, 2026

Predict context rot, sign every agent write, tier reads. Markdown-native, 100% local.

已验证STDIO仅桌面文件与存储知识与记忆

概览

AI 生成的概览

本地 MCP 服务器，为 Markdown 笔记库评估上下文腐化风险、按新鲜度分层读取笔记，并记录带签名的代理读写日志。

可以做什么
评估笔记库的上下文腐化风险，给出 0–100 分数、主要因素、因素明细、风险最高的笔记以及笔记库统计与 token 估算。按笔记新鲜度把笔记库划分为工作、情景和语义三层，可设置年龄阈值。为读取、写入、创建和删除操作记录带签名的日志条目，返回签名、密钥指纹和前一哈希。读取全部日志条目或单个会话的条目。
适用场景
适合助手在本地 Markdown 或 Obsidian 风格笔记库上工作时使用：判断上下文退化程度、按新鲜度决定先读哪些笔记，并留下可校验的代理操作记录。
运行要求
以 npm 包形式通过 stdio 在本地运行，可全局安装或用 npx 启动，需要 Node.js。日志工具需要笔记库中存在 Ed25519 密钥对，首次使用前须用配套 CLI 或 Obsidian 插件生成。未声明账号、API 密钥或环境变量。
安装前请注意
日志工具会向笔记库写入带签名的条目，需指向正确的笔记库路径。日志签名依赖笔记库密钥对，非本库密钥签名的条目无法通过校验。可选的时间戳 CLI 只把签名摘要发送到公共日历，不发送笔记内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mnemoscope，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@mnemoscope/mcp-server

MCP server exposing Mnemoscope's context-rot scoring, tiered reading, and signed journal tools to any Model Context Protocol–compatible client (Claude Code, Cursor, ChatGPT desktop, anything that speaks MCP over stdio).

100% local. No cloud. No telemetry. Apache-2.0.

Install

bash
npm install -g @mnemoscope/mcp-server# the `mnemoscope-mcp` binary is now on your PATH

Or run via npx without a global install:

bash
npx -y @mnemoscope/mcp-server

Connect to Claude Code

jsonc
// ~/.claude/settings.json{  "mcpServers": {    "mnemoscope": {      "command": "npx",      "args": ["-y", "@mnemoscope/mcp-server"]    }  }}

Restart Claude Code. The four tools below are discovered automatically.

Tools

ToolInputWhat it returns
predict_rotvault_path0–100 risk score, dominant factor, full factor breakdown, top-5 risk notes, vault stats
get_tiered_readvault_path, optional working_max_age_days, episodic_max_age_daysWorking / episodic / semantic split of the vault by freshness
record_journalvault_path, session_id, op (read/write/create/delete), target_path, optional contentThe signed entry, including its sig, keyFingerprint, and prevHash
read_journalvault_path, optional session_idAll journal entries, or a single session's

Example — predict_rot

json
{  "rot_risk": 41,  "dominant_factor": "tokenVolume",  "factors": {    "tokenVolume": 100, "semanticRedundancy": 0,    "distractorDensity": 2.65, "structuralCoherence": 100, "freshnessSpread": 0  },  "top_risk_notes": [    { "relPath": "brainstorms/.../transcript.md", "approxTokens": 13439, "reason": "very large note" }  ],  "vault_stats": { "noteCount": 113, "approxTokens": 506823 },  "baseline_model": "v0-heuristic",  "version": "0.1.0"}

Bootstrap a vault

Before the journal tools work the vault needs an Ed25519 keypair. The companion @mnemoscope/cli ships mnemoscope-init for that:

bash
npx -p @mnemoscope/cli mnemoscope-init /path/to/your/vault

The auto-onboarding modal in the Obsidian plugin does the same on first launch.

Verify the journal

bash
npx -p @mnemoscope/cli mnemoscope-verify /path/to/your/vault

Exits non-zero on field tampering, hash-chain break, or entries signed by a key the current vault does not own.

What this server does NOT do

  • It does not store or transmit your vault content. All reads are local; all writes are local.
  • It does not call any external service. (The optional mnemoscope-timestamp CLI in @mnemoscope/cli POSTs only a SHA-256 digest of each journal entry's signature to a public OpenTimestamps calendar — never any vault content.)
  • It does not replace a memory store. It is an instrument for one — see the README for the comparison with Letta, Mem0, Zep, Cognee, MemPalace, and Smart Connections.

Repo + docs

License

Apache-2.0.

来源：packages/mcp-server/README.md，提交 914e15a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分