Mnemoscope

@mnemoscope/mcp-server

Mnemoscopeのコンテキスト劣化スコアリング、段階的な読み取り、署名付きジャーナルのツールを、Model Context Protocol互換のあらゆるクライアント（Claude Code、Cursor、ChatGPT デスクトップ、stdio 経由で MCP を利用できるもの）に提供する MCP サーバーです。

すべてローカルで動作します。クラウドは使用しません。テレメトリーもありません。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 を再起動してください。以下の 4 つのツールが自動的に検出されます。

ツール

ツール	入力	戻り値
predict_rot	vault_path	0～100 のリスクスコア、支配的な要因、要因の詳細な内訳、リスクメモの上位 5 件、Vault の統計
get_tiered_read	vault_path、任意の working_max_age_days、episodic_max_age_days	新しさに基づく Vault の作業／エピソード／セマンティックの分類
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"
}

Vault を初期化する

ジャーナルツールを使うには、Vault に Ed25519 鍵ペアが必要です。付属の @mnemoscope/cliには、そのための mnemoscope-init が含まれています。

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

Obsidian プラグインの自動オンボーディングモーダルでも、初回起動時に同じ処理を行います。

ジャーナルを検証する

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

フィールドの改ざん、ハッシュチェーンの破損、または現在の Vault が所有していない鍵で署名されたエントリーが見つかった場合、ゼロ以外の終了コードで終了します。

このサーバーが行わないこと

• Vault のコンテンツを保存または送信しません。読み取りも書き込みもすべてローカルで行われます。
• 外部サービスを呼び出しません。（@mnemoscope/cliの任意の mnemoscope-timestamp CLI は、各ジャーナルエントリーの署名の SHA-256 ダイジェストのみを公開 OpenTimestamps カレンダーに POST します。Vault のコンテンツは一切送信しません。）
• メモリーストアの代替ではありません。メモリーストアのための計測ツールです。Letta、Mem0、Zep、Cognee、MemPalace、Smart Connections との比較については README をご覧ください。

リポジトリとドキュメント

• ソース、課題、リリース：https://github.com/toonight/Mnemoscope
• アーキテクチャ、脅威モデル、科学的な姿勢については、メインの READMEをご覧ください。

ライセンス

Apache-2.0。