AI và LLMAgent

Bộ nhớ cho trợ lý AI qua MCP

Trao cho Claude, Cursor, VS Code hoặc agent của riêng bạn một bộ nhớ, ghi chú, nhật ký sự kiện, mẫu prompt và tìm kiếm tài liệu, thông qua một máy chủ MCP.

công cụ cố định
28
lệnh tùy ý
0
mã nguồn mở
Apache-2.0
Bước 1 trên 5
Kết nối máy chủ

Một lệnh thêm HotKV vào Claude Code. Cursor và Claude Desktop dùng một mục mcpServers thay thế.

Phiên ví dụplaying
# Kết nối máy chủ
$ claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace team-docs
(hotkv added as an MCP server)

Một hướng dẫn minh họa động với các lệnh HotKV thật và phản hồi ví dụ. Nhấn vào bất kỳ bước nào để nhảy tới đó. Lệnh và phản hồi giữ nguyên bằng tiếng Anh, đúng như bạn gõ và thấy trong HotKV.

Vấn đề

Trợ lý AI quên mọi thứ khi cuộc chat kết thúc, và trao cho chúng quyền truy cập cơ sở dữ liệu thô để khắc phục điều đó là nguy hiểm. Chỉ một lệnh sai từ mô hình cũng có thể xóa sạch dữ liệu hoặc đọc khóa của tenant khác.

HotKV xử lý như thế nào

hotkv-mcp trao cho trợ lý một bộ cố định 28 công cụ cho khóa, hash và list, bộ nhớ hội thoại, ghi chú làm việc, nhật ký sự kiện, bản tóm tắt cuộn, sổ đăng ký prompt và tìm kiếm tài liệu. Không có công cụ nào chạy một lệnh tùy ý, một namespace giới hạn agent trong một tiền tố, và chế độ chỉ đọc loại bỏ mọi công cụ ghi.

Từng bước một

Điều gì xảy ra, từng lệnh một

  1. 01

    Kết nối máy chủ

    Một lệnh thêm HotKV vào Claude Code. Cursor và Claude Desktop dùng một mục mcpServers thay thế.

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

    “Remember our release checklist”

    Trợ lý lưu một ghi chú làm việc bằng công cụ memory_set_note. Nó nằm dưới tiền tố team-docs.

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

    Tuần sau, trong một cuộc chat mới

    Một cuộc hội thoại mới không có lịch sử, nhưng ghi chú vẫn còn trong HotKV.

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

    Tìm kiếm tài liệu của nhóm

    Tài liệu được nạp bằng rag_ingest được tìm theo độ liên quan từ khóa, không cần mô hình embedding.

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

    Các nhóm khác nằm ngoài tầm với

    Mọi tên đều được lưu dưới team-docs:, nên lệnh này nhắm tới team-docs:other-team:secrets, vốn không tồn tại. Khóa của nhóm khác thậm chí không thể gọi tên, và không công cụ nào xóa sạch cơ sở dữ liệu hay chạy lệnh thô.

    tool delete {"key": "other-team:secrets"}
Phù hợp ở đâu

Các tình huống thực tế

Nhóm kỹ thuật

Một máy chủ MCP chỉ đọc dùng chung cho phép trợ lý của mọi lập trình viên tìm kiếm cùng các runbook và ghi chú thiết kế.

Trợ lý cá nhân

Sở thích, tác vụ đang làm và quyết định được giữ dưới dạng ghi chú và bản tóm tắt, nên trợ lý tiếp tục từ chỗ nó đã dừng.

Nền tảng agent

Agent của mỗi khách hàng có namespace riêng trên một máy chủ và không thể thấy các agent khác.

Tích hợp sẵn

Bạn nhận được gì

Bộ công cụ cố định, an toàn

28 công cụ và không có cách nào chạy một lệnh tùy ý. Mỗi công cụ khai báo nó đọc, ghi hay xóa.

Namespace

--namespace giới hạn một agent trong một tiền tố mà nó không bao giờ thấy. Hãy cho mỗi agent một tiền tố không phải phần đầu của tiền tố khác.

Chế độ chỉ đọc

--read-only thậm chí không đăng ký các công cụ ghi.

Kết quả có giới hạn

Giá trị và danh sách bị chặn trên để một giá trị khổng lồ không làm ngập ngữ cảnh của mô hình.

Claude Desktop, Cursor và các client mcpServers khác

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

Câu hỏi thường gặp

Những client nào hoạt động với nó?

Bất kỳ client MCP nào, gồm Claude Code, Claude Desktop, Cursor và VS Code. Nó nói stdio cho client cục bộ và streamable HTTP cho dùng chung.

Nó có cần giấy phép HotKV không?

Các công cụ khóa, hash và list hoạt động trên mọi máy chủ. Các công cụ bộ nhớ, prompt và tìm kiếm tài liệu dùng các engine AI của HotKV, cần một giấy phép bao gồm chúng.

Transport HTTP có được xác thực không?

Không. Hãy giữ nó trên localhost hoặc sau một reverse proxy có xác thực, và cho nó namespace riêng cùng chế độ chỉ đọc khi có thể.

Trường hợp sử dụng liên quan

Thử trên khối lượng công việc của chính bạn

HotKV nói giao thức Redis, nên bạn có thể trỏ một client hiện có tới nó và chạy chính những lệnh này.