Memory MCP：AIのための永続的な知識グラフ

AIアシスタントが会話間で情報を記憶できることを望んだことはありませんか？プロジェクト構造、コーディングの好み、または毎回繰り返したくない重要なコンテキストを記憶するように？

Memory MCPはまさにそれを提供します - Claudeがチャットセッション間で情報を記憶できる永続的な知識グラフです。Claude Codeには現在、ファイルベースのメモリ機能が標準搭載されています。Memory MCPは、自分で管理できる構造化されたクエリ可能な知識グラフとしてそれを補完します。

2026年11月4日更新： セットアップ手順を修正しました。Claude Codeに--scope globalはありません（--scope userを使います）。userスコープとlocalスコープのサーバーは~/.claude/.mcp.jsonではなく~/.claude.jsonに保存されます。また、サーバーは相対パスをプロジェクトではなく自身のパッケージディレクトリを基準に解決するため、MEMORY_FILE_PATHはすべて絶対パスにしました。

Memory MCPとは？

Memory MCP（Knowledge Graph Memory Serverとしても知られる）は、JSONLファイルとして保存されたローカル知識グラフを使用してClaudeに永続的メモリを提供する公式のAnthropic MCPサーバーです。

コアコンセプト：知識グラフ

システムは3つのコアコンポーネントを使用します：

エンティティ（Entities） - 知識グラフの主要ノード（人、プロジェクト、概念）
リレーション（Relations） - エンティティ間の有向接続（能動態で保存）
オブザベーション（Observations） - エンティティに関する個別の情報片

主要機能

永続的メモリ 🧠
- チャットセッション間で情報が保持される
- ローカルJSONLファイルに保存
- 外部サーバーにデータを送信しない
構造化された知識 🕸️
- エンティティとリレーションを持つ知識グラフ
- 概念間のセマンティックな関係
- クエリとトラバースが容易
プライバシーファースト 🔒
- すべてのデータをローカルに保存
- データを完全に制御
- クラウド依存なし
クロスセッションコンテキスト 🔄
- Claudeが以前の会話を記憶
- 過去の議論に基づいて構築
- コンテキストを繰り返す必要なし

インストールとセットアップ

方法1：公式CLI（推奨）

# このプロジェクトのみ（localスコープ、~/.claude.jsonに保存）
# プロジェクトルートで実行：シェルが$PWDを絶対パスに展開します
claude mcp add \
  --scope local \
  memory \
  -e MEMORY_FILE_PATH="$PWD/.claude/memory.jsonl" \
  -- npx -y @modelcontextprotocol/server-memory

# すべてのプロジェクト（userスコープ）
claude mcp add \
  --scope user \
  memory \
  -e MEMORY_FILE_PATH="$HOME/.claude/memory.jsonl" \
  -- npx -y @modelcontextprotocol/server-memory

npx経由で実行する場合、サーバーにはNode.js 24以降が必要です。

MEMORY_FILE_PATHには絶対パスを指定してください。 サーバーは相対パスを、プロジェクトではなく自身のパッケージディレクトリ（npxの場合はnpmキャッシュ内のフォルダー）を基準に解決します。~/で始まるパスは、サーバー自身が展開する現行リリース（2026年10月のv1.0.0以降）なら使えますが、それ以前の日付形式のバージョン（2026.8.31まで）では相対パスとして扱われていました。~の展開をシェルに任せないでください。JSONの設定はシェルを通りませんし、zsh（macOSのデフォルト）やPOSIX shは-e KEY=~/...を入力どおりのまま渡します。"$HOME/..."や"$PWD/..."なら、bashでもzshでも展開されます。

プロジェクト用のコマンドでlocalスコープを使うのは、マシン固有のこのパスを自分の~/.claude.jsonにとどめるためです。--scope projectにすると、チームで共有する.mcp.jsonに書き込まれます。

方法2：手動設定

プロジェクトルートの.mcp.json（projectスコープ）を編集します。userスコープとlocalスコープのサーバーはClaude Codeが管理する~/.claude.jsonに保存されるため、そちらはclaude mcp addで追加してください：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "/Users/you/my-project/.claude/memory.jsonl"
      }
    }
  }
}

実際の使用例

例1：プロジェクトアーキテクチャを記憶

あなた：「記憶して：このプロジェクトは5つのサービスを持つマイクロサービスアーキテクチャを使用：
auth、api、database、cache、queue」

Memory MCPが作成：
- エンティティ：「project-architecture」（タイプ：architecture）
- オブザベーション：「マイクロサービスアーキテクチャを使用」
- エンティティ：「auth-service」（タイプ：service）
- リレーション：project-architecture -> contains -> auth-service
...

次のセッション：
あなた：「プロジェクトアーキテクチャは何ですか？」
Claude：「あなたのプロジェクトは5つのサービスを持つマイクロサービスアーキテクチャを使用しています...」

例2：コーディングの好みを記憶

あなた：「letよりconstを、function宣言よりアロー関数を好む」

Memory MCPが作成：
- エンティティ：「coding-preferences」（タイプ：preferences）
- オブザベーション：「letよりconstを好む」
- オブザベーション：「function宣言よりアロー関数を好む」

後で：
Claudeがコードを書く際に自動的にこれらの好みを適用

利用可能なツール

1. `create_entities` - エンティティの作成

2. `create_relations` - リレーションの作成

3. `add_observations` - オブザベーションの追加

4. `search_nodes` - ノードの検索

5. `open_nodes` - 特定のノードを開く

6. `delete_entities` - エンティティの削除

7. `delete_observations` - オブザベーションの削除

8. `read_graph` - グラフ全体を読み取る

ベストプラクティス

✅ 推奨

構造化されたエンティティ名 - 明確な命名を使用
明確なエンティティタイプ - タイプの一貫性を保つ
能動態のリレーション - 受動態ではなく「depends-on」を使用
粒度の細かいオブザベーション - 具体的で明確に保つ
定期的なメモリ監査 - 定期的にメモリグラフを確認

❌ 避けるべき

機密データの保存 - パスワード、APIキー、個人情報を保存しない
重複エンティティ - 作成前にエンティティの存在を確認
曖昧なオブザベーション - 具体的で実行可能に保つ
循環参照 - グラフトラバースで混乱を引き起こす可能性

メモリスコープ戦略

戦略1：プロジェクト固有のメモリ

戦略2：グローバル共有メモリ

戦略3：ハイブリッドアプローチ

他のMCPとの統合

Memory + Filesystem MCP

Memory + Context7 MCP

結論

Memory MCPは、Claude Codeの組み込みファイルベースメモリに加えて、構造化されたクエリ可能なナレッジグラフを提供し、Claudeに走査・検索できる永続的なコンテキスト認識を与えます。これにより実現：

✅ クロスセッション継続性
✅ プロジェクト知識の蓄積
✅ パーソナライズされたAI支援
✅ コンテキストの繰り返しの削減

あなたに適していますか？

使用シナリオ	推奨度
長期プロジェクト	⭐⭐⭐⭐⭐
複数の関連プロジェクト	⭐⭐⭐⭐⭐
チーム知識共有	⭐⭐⭐⭐
個人的なコーディング好み	⭐⭐⭐⭐⭐
一回限りのタスク	⭐⭐

今すぐ始める

インストール（プロジェクトルートで実行）：claude mcp add memory -e MEMORY_FILE_PATH="$PWD/.claude/memory.jsonl" -- npx -y @modelcontextprotocol/server-memory
知識グラフの構築を開始
永続的AIメモリを楽しむ