Adaptive Memory Graph

Adaptive Memory Graph

会話セッションをまたいで、Claude に永続的かつインテリジェントなメモリを提供する MCP サーバープラグインです。知識を、重み付けされた相互接続ノードとしてグラフに保存し、会話を通じて進化させます。使用されるノードは重みが増し、使用されないノードは減衰して、最終的にアーカイブされます。

Claude Code と Claude Desktop に対応しています。

機能

• 重み付けされたメモリノード — 重要なメモリは目立つ状態を保ち、古くなったものは薄れていきます
• ドメインをまたぐつながり — トピックをまたいで関連する知識をリンクします
• 時間ベースの減衰 — グラフが自動的に整理され、関連性のあるメモリだけが残ります
• 暗号化ストレージ — AES-256-GCM 暗号化と macOS Keychain による鍵の保管
• セッションログ記録 — アクセスされたメモリと、その反応を追跡します
• ドメイン別の整理 — ノードをドメイン別（例：health_and_safety、personal、ideas_and_projects）に整理します
• チャット履歴の取り込み — 過去の Claude Code セッションを確認し、知識を抽出します

インストール

pip install adaptive-memory-graph

または、uv を使用します。

uv pip install adaptive-memory-graph

セットアップ

Claude Code

claude mcp add adaptive-memory-graph -s user -- amg-server

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "adaptive-memory-graph": {
      "command": "amg-server"
    }
  }
}

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

ツール

ツール	説明
amg_load_index	セッション開始時に軽量なグラフインデックスを読み込みます
amg_expand_branch	文脈上関連がある場合にノードの全内容を取得します
amg_get_connected_nodes	ドメインをまたいで関連ノードを検索します
amg_log_session	会話終了時にセッションの概要を記録します
amg_update_graph	保留中のログを処理し、重みの減衰を適用します
amg_export_report	人が読みやすいグラフの概要を生成します
amg_manual_adjust	ノードの重みを増減させるほか、アーカイブまたは削除します
amg_add_node	グラフに新しいノードを追加します
amg_search_nodes	タイトル、概要、タグ、または内容でノードを検索します
amg_list_chat_sessions	確認可能な Claude Code のチャットセッションを一覧表示します
amg_read_chat_session	チャットセッションの会話内容を読み込みます

仕組み

1. セッション開始時 — Claude が amg_load_index を呼び出し、メモリグラフの軽量な概要を取得します
2. 会話中 — トピックに関連性がある場合、Claude が特定のノードを展開して、より詳しいコンテキストを取得します
3. セッション終了時 — Claude がアクセスされたノードを通知なしで記録し、新しいノードを提案します
4. セッション間 — 重みの減衰が実行され、役に立たなかったメモリがアーカイブされます

ノードは暗号化された JSON としてディスク上に保存されます（~/.amg/graph.json.enc）。暗号化キーは macOS Keychain に保存されます。

要件

• Python 3.10+
• macOS（Keychain を使用した暗号化キーの保管用）

ライセンス

MIT