r3

r3

MCP クライアント（Claude Desktop、Claude Code、Cursor）向けの永続メモリです。完全にお使いのマシン上で動作し、アカウントや API キーは不要で、開始時にクラウドサービスも必要ありません。

クイックスタート

npx @n3wth/r3

このコマンドを実行するだけで、組み込み Redis インスタンスとローカルベクトルインデックスを基盤とする MCP サーバーが起動します。別途データベースをインストールする必要も、サインアップする必要もありません。

仕組み

MCP client (Claude Desktop / Claude Code / Cursor)
        |
        v
   r3 MCP server (stdio)
        |
   +----+-----------------------+
   |                            |
embedded Redis            vectra local index
(redis-memory-server,      (on-disk vector store
 auto-downloaded binary,    for semantic search,
 no external service)       no external service)
   |
   +--- optional ---> Mem0 cloud API (MEM0_API_KEY)
                       cross-device sync, off by default

• 組み込み Redis — redis-memory-server がローカルの Redis バイナリをダウンロードして管理します。メモリの内容とメタデータを保存します。起動できない場合、r3 はプロセス内ストアにフォールバックします。
• vectra — セマンティック検索に使用する、ローカルのファイルベースベクトルインデックスです。ネットワーク通信や外部ベクトルデータベースはありません。
• Mem0（任意） — MEM0_API_KEY が設定されている場合、r3 は Mem0 のクラウド API にも同期するため、複数のマシンでメモリを利用できます。キーがなければ、データがマシンの外に送信されることはありません。

MCP クライアントの設定

Claude Desktop

claude_desktop_config.json を編集します（macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "r3": {
      "command": "npx",
      "args": ["@n3wth/r3"]
    }
  }
}

Claude Code

claude mcp add r3 "npx @n3wth/r3"

Cursor

プロジェクト内の .cursor/mcp.json（またはグローバルの Cursor MCP 設定）に追加します。

{
  "mcpServers": {
    "r3": {
      "command": "npx",
      "args": ["@n3wth/r3"]
    }
  }
}

設定を編集した後、クライアントを再起動します。新しい会話で次のように入力します。

You: Remember that I prefer TypeScript and dark mode.
AI: I'll remember that.

[new conversation]

You: What are my preferences?
AI: You prefer TypeScript and dark mode.

ツール

ツール	説明
add_memory	任意のメタデータや優先度を付けて内容を保存します
search_memory	セマンティック検索またはキーワード検索でメモリを検索します
get_all_memories	ページネーション付きで保存済みメモリを一覧表示します
get_memory	ID を指定して特定のメモリを取得します
update_memory	既存のメモリの内容またはメタデータを変更します
delete_memory	メモリを削除します
deduplicate_memories	重複するメモリを検出して統合します
cache_stats	キャッシュヒット率とストレージ統計を報告します
sync_status	Mem0 クラウドとの同期状況を報告します
optimize_cache	キャッシュのメンテナンスを実行します
import_memories	メモリを一括インポートします

拡張モード（デフォルト。INTELLIGENCE_MODE=enhanced）では、次のツールが追加されます。

ツール	説明
extract_entities	テキストから名前付きエンティティを抽出します
get_knowledge_graph	エンティティと関係性のグラフを返します
find_connections	指定したエンティティに関連するエンティティを検索します

設定

環境変数はすべて任意です。

変数	説明	デフォルト
REDIS_URL	組み込み Redis の代わりに外部 Redis を使用します	組み込みサーバー
MEM0_API_KEY	Mem0 クラウド同期を有効にします	未設定（ローカルのみ）
MEM0_USER_ID	メモリの名前空間	default
INTELLIGENCE_MODE	enhanced または basic	enhanced

クラウド同期を有効にする例：

{
  "mcpServers": {
    "r3": {
      "command": "npx",
      "args": ["@n3wth/r3"],
      "env": {
        "MEM0_API_KEY": "mem0_..."
      }
    }
  }
}

比較

	r3	mem0 (OSS)	zep
設定不要で完全にローカル実行可能	はい（Redis + vectra を組み込み）	設定した Postgres／ベクトル DB が必要です	設定した Postgres インスタンスが必要です
試すのに API キーが必要	いいえ	いいえ（セルフホスト）／はい（クラウド）	はい（クラウド）、またはセルフホスト環境のセットアップが必要です
オプションのクラウド同期	はい、Mem0 経由	該当なし（クラウド版が該当）	はい

この表は、各プロジェクトのドキュメントで確認できるセットアップ要件のみを反映しており、ベンチマーク性能や機能の網羅性は反映していません。利用する前に、最新の上流ドキュメントで確認してください。

既知の問題

macOS の一部の環境でネイティブモジュールのビルドに失敗するなど、現在の制限事項については LAUNCH_AUDIT.md を参照してください。

ドキュメント

完全なドキュメントは r3.n3wth.com をご覧ください。

ライセンス

MIT