Memory MCP

AIコーディングアシスタント向けの永続メモリおよびセッション全文検索機能。 MCP サーバーとして公開されます。

課題

AIコーディングアシスタントは、セッション間で情報をすべて忘れてしまいます。アーキテクチャの決定事項、ユーザー設定、プロジェクトのコンテキスト、先週火曜日にデバッグした内容など、すべて消えてしまいます。そのため、常に同じことを説明し直す必要があります。

Memory MCPは、以下の2つの機能でこれを解決します。

1. 明示的メモリ -- セッションをまたいで保持されるメモ、決定事項、パターン、設定を保存します。アシスタントがあなたの指示を記憶します。

2. セッション検索 -- 会話履歴全体に対する全文検索。ログをスクロールすることなく、3週間前に議論した内容を見つけ出せます。

データベースサーバーは不要です。バックグラウンドプロセスも不要です。クラウドも使いません。マシン上の1つのSQLiteファイルで完結します。

Related MCP server: MCP Vector Memory

サポートされているセッションソース

新しいソースを追加するには、パーサーファイル1つとレジストリへの登録が必要です。新しいセッションソースの追加を参照してください。

インストール

SQLite FTS5サポートを備えたPython 3.11以上が必要です（標準のPythonビルドに含まれています）。

pip install -e .

または、uv を使用して直接実行します（インストール不要）：

uv run --directory /path/to/memory_mcp python -m memory_mcp

MCP設定

MCPクライアントの設定（例: ~/.claude/mcp.json またはプロジェクトレベルの .mcp.json）に追加します：

pipインストールの場合：

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp"
    }
  }
}

uvを使用する場合（インストール不要）：

{
  "mcpServers": {
    "memory": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/memory_mcp", "python", "-m", "memory_mcp"]
    }
  }
}

ツール

メモリ（明示的知識ストア）

セッション（過去の会話検索）

仕組み

起動時に、Memory MCPは設定されたセッションディレクトリをスキャンし、すべての会話を FTS5 全文検索インデックスを備えたローカルのSQLiteデータベースにインデックス化します。次回の起動時からは、mtime（更新日時）が変更されていないファイルはスキップされます。

• データベースの場所: ~/.memory_mcp/memory.db (環境変数 MEMORY_MCP_DB で上書き可能)

• セッションソース: 標準的な場所から自動検出されます（環境変数 MEMORY_MCP_SOURCES で拡張可能。フォーマット: type:path;type:path）

• インデックス化: ファイルのmtimeによる増分更新、8スレッドによる並列処理

• 検索: BM25ランキング、前方一致、フレーズサポートを備えたFTS5

新しいセッションソースの追加

1. memory_mcp/parsers/your_source.py を作成し、SessionParser プロトコルを実装します：

   • source_type: str 属性

   • parse_file(path: str) -> ParsedSession | None メソッド

2. memory_mcp/parsers/__init__.py に登録します

3. memory_mcp/config.py にディレクトリ検出機能を追加します

例として parsers/claude_code.py または parsers/omp.py を参照してください。

テスト

python tests/test_e2e.py

エンドツーエンドテストでは、MCPサーバーをサブプロセスとして起動し、stdioプロトコル経由ですべての8つのツールを実行して応答を検証します。使い捨てのデータベースを使用するため、実際のデータは変更されません。

アーキテクチャ

memory_mcp/
  server.py        # FastMCP entry point, lifespan manages DB + startup scan
  config.py        # Auto-detects session dirs, DB path
  db.py            # SQLite + FTS5 schema, all queries, sync triggers
  scanner.py       # Walks session dirs, dispatches to parsers, parallel indexing
  parsers/
    base.py        # ParsedSession / ParsedMessage dataclasses, SessionParser protocol
    claude_code.py # Claude Code JSONL parser (merges streamed assistant blocks)
    claude_history.py # Claude Code history.jsonl parser (one file, many sessions)
    omp.py         # OMP JSONL parser
    opencode.py    # OpenCode SQLite parser (reads DB directly, read-only)
  tools/
    memory.py      # save_memory, search_memory, list_memories, delete_memory
    sessions.py    # list_sessions, get_session, search_sessions, refresh_sessions

ライセンス

MIT