r3

io.github.n3wth由 GitHub 帳號 n3wth 發布v1.3.2更新於 Oct 24, 2026

Local Redis memory MCP for AI apps with hybrid caching and optional Mem0 cloud backup.

已驗證STDIO僅桌面資料庫知識與記憶

概覽

AI 產生的概覽

為助理提供本機持久記憶儲存與語意搜尋,底層使用內嵌 Redis 和本機向量索引。

可以做什麼
r3 以本機 MCP 伺服器形式執行,負責儲存記憶並在之後檢索,讓偏好與事實能跨對話保留。工具包括 add_memory、search_memory、get_all_memories、get_memory、update_memory、delete_memory、deduplicate_memories、import_memories,以及 cache_stats、sync_status 和 optimize_cache。增強模式另提供 extract_entities、get_knowledge_graph 和 find_connections,用於實體與關係查詢。
適用情境
適合希望助理在對話之間記住使用者偏好、筆記或專案脈絡,又不想架設外部資料庫或註冊帳號的情境。也適合需要對已存記憶做語意檢索或小型本機知識圖譜的工作流程。
執行需求
透過 stdio 在本機執行,以 npx @n3wth/r3 啟動,因此需要 Node.js。它會下載並管理內嵌 Redis 執行檔,並在磁碟上保留本機向量索引;啟動不需註冊或 API 金鑰。選用環境變數:REDIS_URL 指向外部 Redis,MEM0_API_KEY 啟用雲端同步,MEM0_USER_ID 用於命名空間,INTELLIGENCE_MODE 選擇增強或基礎模式。僅支援桌面用戶端。
安裝前請注意
記憶類工具會寫入、修改和刪除已存資料,deduplicate_memories 還會合併紀錄,因此讓助理清理記憶前應先確認。設定 MEM0_API_KEY 會把記憶傳送到 Mem0 雲端 API 以跨裝置同步;不設定則資料不離開本機。README 提到部分 macOS 環境有原生模組建置失敗的問題。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 r3,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

r3

[npm version] [npm downloads] [License: MIT]

Persistent memory for MCP clients (Claude Desktop, Claude Code, Cursor) that runs entirely on your machine, with no accounts, no API keys, and no cloud service required to start.

[Memory persisting across two separate server processes]

Quick start

bash
npx @n3wth/r3

That single command starts an MCP server backed by an embedded Redis instance and a local vector index. There is no separate database to install and no signup step.

How it works

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
  • Embedded Redis — redis-memory-server downloads and manages a local Redis binary for you. It stores memory content and metadata. If it cannot start, r3 falls back to an in-process store.
  • vectra — a local, file-backed vector index used for semantic search. No network calls, no external vector database.
  • Mem0 (optional) — if MEM0_API_KEY is set, r3 also syncs to Mem0's cloud API so memories can follow you across machines. Without a key, nothing leaves your machine.

MCP client configuration

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Claude Code

bash
claude mcp add r3 "npx @n3wth/r3"

Cursor

Add to .cursor/mcp.json in your project (or the global Cursor MCP config):

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

Restart the client after editing config. In a new conversation:

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.

Tools

ToolDescription
add_memoryStore content with optional metadata and priority
search_memoryQuery memories using semantic or keyword search
get_all_memoriesList stored memories with pagination
get_memoryRetrieve a specific memory by ID
update_memoryModify existing memory content or metadata
delete_memoryRemove a memory
deduplicate_memoriesFind and merge duplicate memories
cache_statsReport cache hit rate and storage stats
sync_statusReport Mem0 cloud sync status
optimize_cacheRun cache maintenance
import_memoriesBulk import memories

Enhanced mode (default, INTELLIGENCE_MODE=enhanced) adds:

ToolDescription
extract_entitiesExtract named entities from text
get_knowledge_graphReturn the entity/relationship graph
find_connectionsFind entities connected to a given entity

Configuration

Environment variables, all optional:

VariableDescriptionDefault
REDIS_URLUse an external Redis instead of the embedded oneembedded server
MEM0_API_KEYEnables Mem0 cloud syncunset (local only)
MEM0_USER_IDNamespace for memoriesdefault
INTELLIGENCE_MODEenhanced or basicenhanced

Example with cloud sync enabled:

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

Comparison

r3mem0 (OSS)zep
Runs fully local with zero configyes (embedded Redis + vectra)requires a Postgres/vector DB you configurerequires a Postgres instance you configure
Needs an API key to try itnono (self-hosted) / yes (cloud)yes (cloud), or self-hosted setup
Optional cloud syncyes, via Mem0n/a (is the cloud option)yes

This table only reflects setup requirements observed in each project's own documentation, not benchmark performance or feature completeness. Verify against current upstream docs before relying on it.

Known issues

See LAUNCH_AUDIT.md for current limitations, including a native module build failure on some macOS setups.

Documentation

Full documentation at r3.n3wth.com.

License

MIT

來源:README.md,提交 c4ef538

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.3.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分