/ 目錄 / 演練場 / Stash
● 社群 alash3al ⚡ 即開即用

Stash

作者 alash3al · alash3al/stash

一個輕量的 Go 記憶服務——episodes(時序事件)和 facts(持久知識),透過 MCP 暴露。

Stash 提供兩種儲存模式給 agent:episodes(時間順序事件)和 facts(鍵值持久知識)。輕量、單一二進位檔,可輕鬆在樹莓派上運行。

為什麼要用

核心特性

即時演示

實際使用效果

就緒

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "stash-mcp",
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "stash-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-p",
          "9000:9000",
          "ghcr.io/alash3al/stash:latest"
        ]
      }
    }
  }
}

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

claude mcp add stash-mcp -- docker run -p 9000:9000 ghcr.io/alash3al/stash:latest

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

使用場景

實戰用法: Stash

在 session 之間保持 agent 記憶

👤 開發者 ⏱ ~15 min intermediate

何時使用: 你希望 Claude 記住偏好和最近的上下文。

步驟
  1. 執行 stash
    docker run alash3al/stash✓ 已複製
    → 服務啟動
  2. 連接 MCP
    在 Claude 設定中將 stash 加入為 MCP。✓ 已複製
    → 工具可見
  3. 使用
    remember "user prefers TypeScript over JS";稍後召回。✓ 已複製
    → 記憶召回

結果: 無需付費完整記憶 SaaS 即可實現連貫性。

組合

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

stash-mcp + filesystem

定期將記憶傾倒至磁碟備份

結合 stash-mcp 與 filesystem:定期將記憶傾倒至磁碟備份✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
remember_episode (詳見文件) 附加一個時間軸事件 1 次呼叫
remember_fact (詳見文件) 儲存一個持久事實 1 次呼叫
search (詳見文件) 跨兩個儲存區搜尋 1 次呼叫

成本與限制

運行它的成本

API 配額
本機
每次呼叫 Token 數
費用
免費開源
提示
定期快照資料目錄

安全

權限、密鑰、影響範圍

憑證儲存: 磁碟上的資料庫
資料出站: 預設無

故障排查

常見錯誤與修復

嵌入端點缺失

設定 EMBEDDING_URL,或以僅關鍵字模式運行

替代方案

Stash 對比其他方案

替代方案何時用它替代權衡
memsearch你需要 Milvus 支援的規模設定較複雜

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

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