/ 目錄 / 演練場 / mcp-memory-service
● 社群 doobidoo ⚡ 即開即用

mcp-memory-service

作者 doobidoo · doobidoo/mcp-memory-service

為你的 AI 提供持久的長期記憶,支援語義搜尋、標籤、5ms 取出速度和雲端同步 — SQLite 本地、Cloudflare 多設備同步

doobidoo/mcp-memory-service 是一個 Python MCP,為代理儲存語義記憶。預設 SQLite-vec 後端速度很快(5ms),Cloudflare 後端可跨設備同步,混合模式先寫本地後異步複製。包括 REST API、網頁儀表板和用於遠端存取的 OAuth 2.0。

為什麼要用

核心特性

即時演示

實際使用效果

memory-service.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "memory-service",
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "memory-service": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-memory-service"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add memory-service -- uvx mcp-memory-service

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: mcp-memory-service

如何讓 Claude 穩定記住你的偏好和背景

👤 厭倦重複解釋自己的日常進階使用者 ⏱ ~10 min beginner

何時使用: 每次新聊天都從零開始,你想要連貫性。

前置條件
  • uvx 已安裝 — brew install uv
步驟
  1. 播種偏好
    memory_store: 'I work on iOS + Swift projects. Prefer MVVM with @Observable. Always comment in English.' with tags [preference, coding].✓ 已複製
    → 儲存確認
  2. 在未來的會話中取出
    memory_search: 'my coding style preferences'.✓ 已複製
    → 偏好已傳回,代理應用它們
  3. 衰減清理
    顯示 90 天前且最近沒有點擊的記憶 — 提供清除選項。✓ 已複製
    → 待審核的過時清單

結果: Claude 表現得像它記得你。

注意事項
  • 儲存敏感個人資訊會永遠可檢索 — 不要 — 把記憶當公開筆記本。用標籤來分隔。

如何透過 Cloudflare 後端在團隊間共享記憶池

👤 執行共享 AI 工作流程的團隊 ⏱ ~30 min advanced

何時使用: 你希望每位工程師的聊天都記得相同的架構決策。

前置條件
  • Cloudflare 帳號搭配 Workers KV 或 D1 — cloudflare.com,按 Cloudflare 後端文件設定
步驟
  1. 切換後端
    Configure MCP_MEMORY_BACKEND=cloudflare with CF creds in env.✓ 已複製
    → 記憶端點指向 CF
  2. 播種團隊共享記憶
    memory_store: 'Our auth lives in services/auth. Always rotate JWT keys via the rotate-keys Make target.' with tag 'team-arch'.✓ 已複製
    → 已儲存
  3. 從第二台機器驗證
    memory_search 'auth service' — should return the same entry.✓ 已複製
    → 跨設備命中

結果: 在團隊異動中倖存的共享機構記憶。

注意事項
  • 共享記憶中的敏感資料洩露跨團隊 — 每個團隊執行獨立後端;不要儲存祕密

如何在程式設計會話結束時自動收穫學習

👤 大量使用代理的獨立開發者 ⏱ ~5 min beginner

何時使用: 在配對程式設計聊天結束時,關閉前。

步驟
  1. 執行收割機
    memory_harvest on this conversation — extract durable facts (API keys patterns, project decisions, known gotchas). Ignore chit-chat.✓ 已複製
    → 候選記憶的結構化清單
  2. 核准 + 儲存
    以標籤 'project-x' 儲存項目 1、3、5 為記憶。捨棄其餘。✓ 已複製
    → 儲存計數

結果: 低摩擦力捕捉你學到的東西,僅此而已。

組合

與其他 MCP 搭配,撬動十倍槓桿

memory-service + contextplus

使用 Context+ 取得即時 repo 狀態,memory-service 用於持久跨會話事實

將此架構決策儲存到 memory-service,並透過 Context+ 記憶圖將其連結到相關檔案。✓ 已複製
memory-service + github

每次合併 PR 後,將學習收穫到記憶

摘要 org/repo 中最後 10 個合併 PR,提取重複錯誤,並以標籤 'code-review-lessons' 儲存為記憶。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
memory_store content: str, tags?: str[] 儲存持久事實 1 embedding
memory_search query: str, tags?: str[], limit?: int 檢索相關記憶 1 vector search (local)
memory_harvest transcript: str 會話結束捕捉 1 LLM call
memory_store_session session_id, messages 攝取整個聊天 N embeddings

成本與限制

運行它的成本

API 配額
SQLite-vec:無限本地。ChromaDB:本地。Cloudflare:Workers/KV/D1 免費層級很慷慨。
每次呼叫 Token 數
儲存:內容約 100 個 token。搜尋:每個結果約 50 個 token。
費用
免費(開源)。Cloudflare 後端:免費層級通常夠用。
提示
從 SQLite-vec 開始。只有在你需要多設備同步時才切換到混合。

安全

權限、密鑰、影響範圍

最小權限: SQLite 模式的本地檔案系統 CF 模式的 Cloudflare API token
憑證儲存: 透過環境變數的 CF 認證
資料出站: 本地(SQLite)或你的 Cloudflare 帳號(CF)
切勿授予: 不要讓不受信任的提示呼叫 memory_store — 中毒攻擊

故障排查

常見錯誤與修復

ModuleNotFoundError: sqlite_vec

使用 sqlite-vec 額外項目進行 pip/uv 安裝:uvx 'mcp-memory-service[sqlite]'

驗證: python -c 'import sqlite_vec'
Cloudflare backend 403

Token 缺少 Workers/KV 權限。使用特定範圍建立新的 CF API token。

Memories returned aren't relevant

使用更好的模型重新嵌入 — 預設為本地 MiniLM;透過環境變數升級到 nomic-embed。

memory_harvest outputs duplicates

啟用 dedup 設定;收割機將跳過與現有項目的余弦相似度 > 0.95 的項目。

替代方案

mcp-memory-service 對比其他方案

替代方案何時用它替代權衡
mem0你想要託管的記憶 SaaS免費層級外需付費;供應商鎖定
contextplus memory graph你想要記憶與程式碼理解緊密整合限制在一個 repo,不是通用

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills