Memory MCP

🚀 Memory MCP Service

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

English | 中文

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、1回限り）。

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

• エピソード：各会話セッションは自動生成された要約付きの「エピソード」となります。
• エンティティ：会話から抽出された重要な知識（決定、設定、概念）です。
• 2層ストレージ：ユーザーレベル（プロジェクト間で共有）+ プロジェクトレベル（各プロジェクトで分離）です。
• 意味検索：ベクトルベースの検索により、関連する過去のコンテキストを見つけます。

💻 使用例

自動モード（フックを使用）

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

手動モード

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

# 新しいエピソードを開始
memory_start_episode("Login Feature Development", ["auth"])

# 決定を記録
memory_add_entity("Decision", "Use JWT + Redis", "For distributed deployment")

# 履歴を検索
memory_recall("login implementation")

# エピソードを終了
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

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。