AI 與 LLM代理

透過 MCP 為 AI 助理提供記憶體

透過同一個 MCP 伺服器,為 Claude、Cursor、VS Code 或您自己的代理提供記憶體、筆記、事件記錄、提示詞範本與文件搜尋。

個固定的工具
28
個任意指令
0
開源
Apache-2.0
步驟 1 / 5
連接伺服器

一個指令即可把 HotKV 加入 Claude Code。Cursor 與 Claude Desktop 則改用 mcpServers 項目。

範例工作階段playing
# 連接伺服器
$ claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace team-docs
(hotkv added as an MCP server)

以真實 HotKV 指令與範例回覆呈現的動畫導覽。點擊任一步驟即可跳到該步驟。 指令與回覆維持英文,與您在 HotKV 中輸入及看到的完全一致。

問題

AI 助理在聊天結束時就會忘記一切,而為了解決這點直接讓它們存取原始資料庫又很危險。模型只要下錯一個指令,就可能清空資料或讀取另一個租戶的鍵。

HotKV 如何處理

hotkv-mcp 為助理提供一組固定的 28 個工具,涵蓋鍵、雜湊與清單、對話記憶體、工作筆記、事件記錄、滾動摘要、提示詞登錄庫與文件搜尋。沒有任何工具能執行任意指令,命名空間會將代理限制在單一前綴,唯讀模式則會移除所有寫入工具。

逐步說明

逐個指令看看發生了什麼事

  1. 01

    連接伺服器

    一個指令即可把 HotKV 加入 Claude Code。Cursor 與 Claude Desktop 則改用 mcpServers 項目。

    claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace team-docs
  2. 02

    「記住我們的發布檢查清單」

    助理用 memory_set_note 工具儲存一則工作筆記。它會放在 team-docs 前綴之下。

    tool memory_set_note {"session": "releases", "key": "checklist", "value": "1. bump version 2. changelog ..."}
  3. 03

    下週,在新的聊天中

    全新的對話沒有任何歷史,但筆記仍在 HotKV 中。

    tool memory_get_note {"session": "releases", "key": "checklist"}
  4. 04

    搜尋團隊的文件

    以 rag_ingest 匯入的文件,會依關鍵字相關性搜尋,不需要嵌入模型。

    tool rag_search {"pipeline": "runbooks", "query": "rotate TLS certificates", "k": 3}
  5. 05

    其他團隊無法觸及

    每個名稱都儲存在 team-docs: 之下,所以這會指向 team-docs:other-team:secrets,而它並不存在。其他團隊的鍵甚至無法被指名,也沒有任何工具能清空資料庫或執行原始指令。

    tool delete {"key": "other-team:secrets"}
適用之處

真實世界的情境

工程團隊

共用的唯讀 MCP 伺服器,讓每位開發者的助理都能搜尋相同的操作手冊與設計筆記。

個人助理

偏好、進行中的任務與決策會以筆記與摘要的形式保存,讓助理能從上次中斷的地方繼續。

代理平台

每位客戶的代理在同一台伺服器上都有自己的命名空間,彼此看不到對方。

內建

您能獲得什麼

固定且安全的工具集

28 個工具,沒有任何執行任意指令的方式。每個工具都宣告自己是讀取、寫入還是刪除。

命名空間

--namespace 會將代理限制在單一個它自己看不見的前綴。請為每個代理指定不是其他代理前綴開頭的前綴。

唯讀模式

--read-only 甚至不會註冊寫入工具。

有界的結果

值與清單都有上限,因此巨大的值不會灌爆模型的內容。

Claude Desktop、Cursor 與其他 mcpServers 用戶端

json
{
  "mcpServers": {
    "hotkv": {
      "command": "uvx",
      "args": ["hotkv-mcp", "--read-only"],
      "env": { "HOTKV_URL": "hotkv://:your-password@localhost:6379" }
    }
  }
}

常見問題

哪些用戶端可以使用它?

任何 MCP 用戶端,包括 Claude Code、Claude Desktop、Cursor 與 VS Code。它為本機用戶端提供 stdio,為共用情境提供 streamable HTTP。

它需要 HotKV 授權嗎?

鍵、雜湊與清單工具可在任何伺服器上使用。記憶體、提示詞與文件搜尋工具使用 HotKV 的 AI 引擎,需要包含這些引擎的授權。

HTTP 傳輸有經過驗證嗎?

沒有。請將它保持在 localhost,或放在會進行驗證的反向代理之後,並盡可能為它設定專屬的命名空間與唯讀模式。

相關使用情境

在您自己的工作負載上試試看

HotKV 支援 Redis 協定,因此您可以將現有的用戶端指向它,並執行這些相同的指令。