HN 日本語サマリー

← 一覧へ戻る
AI・機械学習

Show HN: MCP Memory – GoogleのOKFとSQLite FTS5を使用した高速エージェントメモリ

Show HN: MCP Memory – Fast Agent Memory Using Google's OKF and SQLite FTS5 (github.com)

46 pointsby pcbmaker2022 コメント

要約

MCP-Memoryは、AIエージェントに永続的かつ長期的なメモリ機能を提供するサーバーです。Open Knowledge Format (OKF) 標準で記録をフォーマットし、ローカルSQLiteインスタンスでインデックス化することで、高速な検索を実現します。このシステムは、セッションを跨いだ状態の永続化、OKF標準への準拠、人間が閲覧可能なディレクトリ構造、そして高速なSQLite FTS5インデックス作成を特徴としています。

全文翻訳

MCP-Memory: OKFバックのエージェントメモリサーバー

MCP-Memory は、Claude Desktop、Cursor、Antigravity、Windsurf、CodexなどのAIエージェントに永続的な長期記憶機能を提供するModel Context Protocol (MCP) サーバーです。

メモリレコードは Open Knowledge Format (OKF v0.2) 標準を使用してフォーマットされ、高速なキー・バリュー検索、タグフィルタリング、コンテンツ検索のためにローカル SQLite インスタンス(FTS5フルテキスト検索対応)でインデックス化されています。

高速スタート: クイックスタートへ直接ジャンプ


主な機能

  • セッションをまたいだ永続的な状態: AIエージェントが、チャットのターンやセッションをまたいで永続するステートフルなメモリ断片を読み取り、保存、検索、削除できるようにします。
  • OKF標準準拠: 各メモリ項目は、YAMLフロントマター(type, key, namespace, tags, generated, sources, verified, status, stale_after)を持つOKF v0.2 Markdownドキュメントとしてフォーマットされ、SPEC.md および OKF_RULES.md に厳密に準拠して保存されます。
  • 二層アーキテクチャ:
    • 人間が閲覧可能なOKFディレクトリ: 各メモリは、階層的なindex.md(ルートindex.mdはokf_version: "0.2"でバージョン管理)とlog.md(更新履歴追跡)を持つmemory/バンドルディレクトリ内に、生の.mdファイルとしてディスクに自動的にダンプおよび同期されます。
    • 高性能SQLiteインデックス: SQLite FTS5(フルテキスト検索)と自動トリガーにより、20ミリ秒未満のキー検索と即時のキーワード検索を実現します。
  • 名前空間の分離: コンテキストの分離(例: user/preferences, project/architecture, default)をサポートします。
  • ゼロボイラープレートセットアップ: クイックセットアップウィザード(python3 setup.py)が、インストールされているMCPツール(Antigravity, Claude, Cursor, Windsurf, Codex)を自動設定します。

MCPツール

サーバーは、対話するエージェントに6つのMCPツールを提供します。

1. memory_store

メモリレコードをOKF v0.2形式で保存または更新します。

  • パラメータ:
    • key (文字列、必須): メモリの一意な識別子またはパス(例: user/preferences/coding_style または project/architecture)。
    • content (文字列またはオブジェクト、必須): 保存するコア情報。
    • project_root (文字列、必須): アクティブなプロジェクトルートディレクトリへの絶対パス(例: /Users/user/Projects/my-app)。
    • tags (文字列の配列、オプション): フィルタリング用の分類タグ。
    • namespace (文字列、オプション、デフォルト: "default"`): スコープ/名前空間。
    • concept_type *(文字列、オプション、デフォルト: "Agent Memory")*: OKFのコンセプトタイプ(例: Metric, Playbook, Attested Computation`)。
    • title (文字列、オプション): 表示名。
    • description (文字列、オプション): 1行の要約。
    • resource (文字列、オプション): 基盤となるアセットの正規URI。
    • status *(文字列、オプション、デフォルト: "stable")*: ライフサイクル状態(draft|stable|deprecated`)。
    • stale_after (文字列、オプション): ISO日付(YYYY-MM-DD)。
    • sources (オブジェクトの配列、オプション): プロビナンスソース [{resource, id, title, author, usage_count, last_modified}]。
    • verified (オブジェクトの配列またはオブジェクト、オプション): 検証イベント [{by, at}]。
    • generated_by (文字列、オプション): アクター規約に従うアクター識別子(<producer>/<version>, human:<id>, process:<id>)。
2. memory_retrieve

キーと名前空間で特定のメモリを取得します。

  • パラメータ:
    • key (文字列、必須): 検索するメモリキー。
    • project_root (文字列、必須): アクティブなプロジェクトルートディレクトリへの絶対パス。
    • namespace (文字列、オプション、デフォルト: "default"`): スコープ/名前空間。
3. memory_search

キーワード、タグ、または名前空間フィルターに一致するメモリを検索します。

  • パラメータ:
    • project_root (文字列、必須): アクティブなプロジェクトルートディレクトリへの絶対パス。
    • query (文字列、オプション): キー、フロントマター、コンテンツ全体を検索するキーワード検索クエリ。
    • tags (文字列の配列、オプション): 特定のタグでフィルタリング。
    • namespace (文字列、オプション): 名前空間に検索を限定。
    • limit (整数、オプション、デフォルト: 10): 結果の最大数。
4. memory_delete

キーと名前空間で特定のメモリレコードを、SQLiteインデックスとディスク上のmemory/バンドルの両方から削除します。

  • パラメータ:
    • key (文字列、必須): 削除するメモリのキー。
    • project_root (文字列、必須): アクティブなプロジェクトルートディレクトリへの絶対パス。
    • namespace (文字列、オプション、デフォルト: "default"`): スコープ/名前空間。
5. memory_get_last

エージェントディレクティブ(セッション開始): 最後の記録セッションチェックポイント(system/last_memory)を取得し、AIエージェントがプロジェクトを開いたりセッションを開始したりした際に、作業がどこで中断されたかを即座に把握できるようにします。

  • パラメータ:
    • project_root (文字列、必須): アクティブなプロジェクトルートディレクトリへの絶対パス。
    • namespace (文字列、オプション、デフォルト: "default"`): スコープ/名前空間。
6. memory_update_last

エージェントディレクティブ(マイルストーンと進捗): マイルストーンの完了、重要な変更、作業の中断時に、正規のセッションチェックポイント(system/last_memory)を更新します。

  • パラメータ:
    • content (文字列またはオブジェクト、必須): 進捗状況の簡単なメモまたは構造化された辞書で、主要なメモリファイルを参照します。
    • project_root (文字列、必須): アクティブなプロジェクトルートディレクトリへの絶対パス。
    • namespace (文字列、オプション、デフォルト: "default"`): スコープ/名前空間。
    • summary (文字列、オプション): 達成されたマイルストーンの1文での説明。

OKF(Open Knowledge Format)構造

保存される各メモリは、OKF v0.2仕様(SPEC.md & OKF_RULES.md)に厳密に準拠しています。

---
type: Agent Memory
title: Coding Style
key: user/preferences/coding_style
namespace: default
tags:
- preferences
- style
status: stable
generated:
  by: mcp-memory/0.2.0
  at: '2026-08-12T19:23:35Z'
created_at: '2026-08-12T19:23:35Z'
updated_at: '2026-08-12T19:23:35Z'
---

User prefers functional programming style with explicit type annotations.

クイックスタート

1. リポジトリのクローン
git clone https://github.com/fellowgeek/mcp-memory
cd mcp-memory
2. インタラクティブセットアップウィザード

setup.pyを実行して、mcp-memoryをAIツールに自動検出・登録します。

python3 setup.py

注意: setup.pyがツールの設定を完了すると、必要に応じてAIクライアントはバックグラウンドでmcp-memoryを自動的に起動します。ターミナルでサーバープロセスを手動で開始したり、実行し続けたりする必要はありません。

3. CLI経由での手動実行(オプション/デバッグ)

起動を手動で確認したい場合、標準入出力(stdio)を確認したい場合、または仮想環境(.venv)を事前に初期化したい場合は、run.shを直接実行できます。

./run.sh

手動クライアント設定

MCPクライアントを手動で設定したい場合は、run.shを指す"memory"サーバーエントリを追加します。

JSON設定(Antigravity, Claude Desktop, Cursor, Windsurf)

クライアントのmcp_config.jsonまたはclaude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "memory": {
      "command": "/ABSOLUTE/PATH/TO/run.sh"
    }
  }
}
TOML設定(Codex Desktop)

~/.codex/config.tomlに追加します。

[mcp_servers.memory]
command = "/ABSOLUTE/PATH/TO/run.sh"
CLI設定
  • Claude Code CLI:
claude mcp add --scope user memory -- /ABSOLUTE/PATH/TO/run.sh
  • Codex CLI:
codex mcp add memory -- /ABSOLUTE/PATH/TO/run.sh

テスト

自動テストスイートを実行して、OKFシリアライゼーション、SQLiteデータベース操作、FastMCPツールの実行を確認します。

python3 test_memory.py

ストレージと環境変数

デフォルトでは、mcp-memoryは各プロジェクトのルートディレクトリ内にプロジェクトごとに分離されたメモリストアを作成します。

  • OKF Markdownファイル(人間が読める形式): プロジェクトルートのmemory/フォルダ。
  • SQLiteデータベース(隠しインデックス): プロジェクトルートの.mcp_memory/memories.db。

この動作は、環境変数を使用してカスタマイズできます。

  • MCP_MEMORY_PROJECT_ROOT: プロジェクトルートディレクトリ(デフォルト: プロセスの現在の作業ディレクトリ cwd)。
  • MCP_MEMORY_DB_PATH: SQLiteデータベースファイルパス(デフォルト: プロジェクトルートからの相対パス .mcp_memory/memories.db)。
  • MCP_MEMORY_DIR: Open Knowledge Format (OKF) .md ファイルのディレクトリ(デフォルト: プロジェクトルートからの相対パス memory)。

ヒント: すべてのプロジェクトで共有される単一のグローバルメモリストアを好む場合は、クライアントのMCP設定でMCP_MEMORY_DB_PATH=~/.mcp_memory/memories.dbおよびMCP_MEMORY_DIR=~/.mcp_memory/memoryを設定します。