memory-mcp

Memory MCP Service

English | 中文

Claude Code 向けの永続メモリ MCP サービスです。会話を自動的に保存し、セッションをまたいで関連する履歴を取得します。

できること： Claude Code と会話するたびに、会話のコンテキスト（決定事項、好み、重要な議論）が保存され、今後のセッションで自動的に呼び出されます。そのため、Claude は常に必要な背景情報を把握できます。

クイックスタート

前提条件

uv（Python パッケージランナー）をインストールします。

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Mac/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Python 3.10～3.13 が必要です（chromadb は Python 3.14 以降と互換性がありません）。

1. 初期化（初回のみ）

ベクトルモデルをダウンロードします（約400MB、一度のみ）。

uvx --from chenxiaofie-memory-mcp memory-mcp-init

2. Claude Code に MCP サーバーを追加する

claude mcp add memory-mcp -s user -- uvx --from chenxiaofie-memory-mcp memory-mcp

3. フックを設定する（推奨）

フックを使うと、メッセージの保存を完全に自動化できます。フックを使わない場合は、メモリツールを手動で呼び出す必要があります。

次の内容を ~/.claude/settings.json に追加します。

{
  "hooks": {
    "SessionStart": [{
      "matcher": ".*",
      "hooks": [{ "type": "command", "command": "uvx --from chenxiaofie-memory-mcp memory-mcp-session-start" }]
    }],
    "UserPromptSubmit": [{
      "matcher": ".*",
      "hooks": [{ "type": "command", "command": "uvx --from chenxiaofie-memory-mcp memory-mcp-auto-save" }]
    }],
    "Stop": [{
      "matcher": ".*",
      "hooks": [{ "type": "command", "command": "uvx --from chenxiaofie-memory-mcp memory-mcp-save-response" }]
    }],
    "SessionEnd": [{
      "matcher": ".*",
      "hooks": [{ "type": "command", "command": "uvx --from chenxiaofie-memory-mcp memory-mcp-session-end" }]
    }]
  }
}

4. 確認する

claude mcp list

memory-mcp: ... - ✓ Connected と表示されます。

これで完了です。新しい Claude Code セッションを開始すると、会話が自動的に保存され、呼び出されるようになります。

仕組み

Session Start ──► Create Episode ──► Monitor Process (background)
                                          │
User Message  ──► Save Message ──► Recall Related Memories ──► Inject Context
                                          │
Claude Reply  ──► Save Response           │
                                          │
Session End   ──► Close Signal ──► Archive Episode + Generate Summary

• エピソード：会話セッションごとに「エピソード」が作成され、自動生成された要約が付与されます
• エンティティ：会話から抽出された重要な知識（決定事項、好み、概念）
• 二層ストレージ：ユーザーレベル（プロジェクト間で共有）＋プロジェクトレベル（プロジェクトごとに分離）
• セマンティック検索：ベクトルベースの検索で、関連する過去のコンテキストを見つけます

使い方

自動モード（フックあり）

フックを設定すると、すべてが自動で行われます。Claude は過去のセッションから関連する履歴をコンテキストとして参照できます。

手動モード

Claude Code でメモリツールを直接呼び出すこともできます。

# Start a new episode
memory_start_episode("Login Feature Development", ["auth"])

# Record a decision
memory_add_entity("Decision", "Use JWT + Redis", "For distributed deployment")

# Search history
memory_recall("login implementation")

# Close episode
memory_close_episode("Completed JWT login feature")

フックのリファレンス

ツールのリファレンス

エンティティの種類

保存場所

• ユーザーレベル：~/.claude-memory/
• プロジェクトレベル：{project-root}/.claude/memory/

git clone https://github.com/chenxiaofie/memory-mcp.git
cd memory-mcp
# Windows:
install.bat
# Mac/Linux:
chmod +x install.sh && ./install.sh

# Windows:
claude mcp add memory-mcp -s user -- "C:\path\to\memory-mcp\venv310\Scripts\python.exe" -m memory_mcp.server

# Mac/Linux:
claude mcp add memory-mcp -s user -- /path/to/memory-mcp/venv310/bin/python -m memory_mcp.server

作者

陈佳俊 (Jiajun Chen) — 中国・杭州を拠点とするフロントエンドエンジニアです。 GitHub @chenxiaofie · [email protected]

本プロジェクトは陈佳俊（GitHub：@chenxiaofie）が開発・保守しています。

ライセンス

MIT ライセンスです。詳細については、LICENSE ファイルをご覧ください。