Mnemoscope

本地服务

github.com记忆与知识126 周前更新

代码仓库访问官网

关于 Mnemoscope

Mnemoscope 的 MCP 服务提供本地工具，用于评估上下文腐化、按新鲜度分层读取 Markdown 资料库并维护签名日志，适合处理本地资料库的 MCP 客户端。

主要功能

01评估上下文腐化风险
02按新鲜度划分资料库读取
03记录签名日志条目
04按会话读取日志条目
05资料库数据保留在本地

适用场景

01评估资料库的上下文腐化风险
02按新鲜度读取工作、情景和语义笔记
03记录带签名的文件操作
04查看某个会话的日志历史

MCP 相关

该服务通过 stdio 向兼容 MCP 的客户端提供上下文腐化评分、分层读取和签名日志工具。读取和写入均在本地进行，不会传输资料库内容。

#memory #obsidian #markdown #claude-code #forensics #rot-detection #tiered-memory #ed25519 #opentimestamps

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "toonight-mnemoscope": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoscope/mcp-server"
      ]
    }
  }
}

启动命令npx -y @mnemoscope/mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@mnemoscope/mcp-server0.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
vault_path	string	是	知识库根目录的绝对路径。

详细介绍

@mnemoscope/mcp-server

MCP 服务向任何兼容 Model Context Protocol 的客户端（Claude Code、Cursor、ChatGPT desktop，以及任何通过 stdio 使用 MCP 的客户端）提供 Mnemoscope 的上下文衰减评分、分层读取和签名日志工具。

100% 本地运行。无云端服务。无遥测。Apache-2.0。

安装

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

也可以通过 npx 运行，无需全局安装：

npx -y @mnemoscope/mcp-server

连接到 Claude Code

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

重启 Claude Code。系统会自动发现以下四个工具。

工具

工具	输入	返回内容
`predict_rot`	`vault_path`	0–100 的风险评分、主要影响因素、完整的因素明细、排名前 5 的风险提示、知识库统计信息
`get_tiered_read`	`vault_path`、可选的 `working_max_age_days`、`episodic_max_age_days`	按新鲜度划分知识库中的工作记忆 / 情景记忆 / 语义记忆
`record_journal`	`vault_path`、`session_id`、`op`（`read`/`write`/`create`/`delete`）、`target_path`、可选内容	已签名的条目，包括其 `sig`、`keyFingerprint` 和 `prevHash`
`read_journal`	`vault_path`、可选的 `session_id`	所有日志条目，或单个会话的日志条目

示例 — `predict_rot`

{
  "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"
}

初始化知识库

日志工具运行前，知识库需要有一对 Ed25519 密钥。配套的 @mnemoscope/cli 提供了 mnemoscope-init 命令来生成密钥：

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

Obsidian plugin 中的自动引导设置弹窗也会在首次启动时执行相同操作。

验证日志

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

如果字段遭到篡改、哈希链断裂，或条目由当前知识库不拥有的密钥签名，命令将以非零状态码退出。

此服务不会做什么

它不会存储或传输你的知识库内容。所有读取和写入操作都在本地进行。
它不会调用任何外部服务。（@mnemoscope/cli 中可选的 mnemoscope-timestamp CLI 只会将每个日志条目签名的 SHA-256 摘要 POST 到一个公开的 OpenTimestamps 日历，绝不会发送任何知识库内容。）
它不会取代记忆存储。它是用于记忆存储的仪器——与 Letta、Mem0、Zep、Cognee、MemPalace 和 Smart Connections 的比较请参阅 README。