IA e LLMAgenti

Memoria per assistenti IA tramite MCP

Dai a Claude, Cursor, VS Code o al tuo agente una memoria, note, un log di eventi, template di prompt e ricerca nei documenti, tramite un solo server MCP.

strumenti fissi
28
comandi arbitrari
0
open source
Apache-2.0
Passo 1 di 5
Collega il server

Un solo comando aggiunge HotKV a Claude Code. Cursor e Claude Desktop usano invece una voce mcpServers.

Sessione di esempioplaying
# Collega il server
$ claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace team-docs
(hotkv added as an MCP server)

Una dimostrazione animata con comandi HotKV reali e risposte di esempio. Clicca su un passo qualsiasi per andarci. Comandi e risposte restano in inglese, esattamente come li digiti e li vedi in HotKV.

Il problema

Gli assistenti IA dimenticano tutto quando la chat finisce, e dare loro accesso diretto al database per rimediare è pericoloso. Un solo comando sbagliato di un modello può cancellare i dati o leggere le chiavi di un altro tenant.

Come lo gestisce HotKV

hotkv-mcp dà a un assistente un insieme fisso di 28 strumenti per chiavi, hash e liste, memoria delle conversazioni, note di lavoro, un log di eventi, riepiloghi progressivi, un registro dei prompt e la ricerca nei documenti. Non esiste uno strumento che esegue un comando arbitrario, un namespace confina l'agente in un solo prefisso e la modalità di sola lettura rimuove ogni strumento di scrittura.

Passo dopo passo

Cosa succede, comando per comando

  1. 01

    Collega il server

    Un solo comando aggiunge HotKV a Claude Code. Cursor e Claude Desktop usano invece una voce mcpServers.

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

    "Ricorda la nostra checklist di rilascio"

    L'assistente salva una nota di lavoro con lo strumento memory_set_note. Finisce sotto il prefisso team-docs.

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

    La settimana dopo, in una nuova chat

    Una conversazione nuova non ha cronologia, ma la nota è ancora in HotKV.

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

    Cerca nei documenti del team

    I documenti acquisiti con rag_ingest vengono cercati per rilevanza delle parole chiave, senza bisogno di un modello di embedding.

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

    Gli altri team restano fuori portata

    Ogni nome viene salvato sotto team-docs:, quindi questo punta a team-docs:other-team:secrets, che non esiste. Le chiavi di un altro team non si possono nemmeno nominare, e nessuno strumento svuota il database o esegue comandi diretti.

    tool delete {"key": "other-team:secrets"}
Dove si usa

Scenari reali

Team di ingegneria

Un server MCP condiviso in sola lettura permette all'assistente di ogni sviluppatore di cercare negli stessi runbook e nelle stesse note di design.

Assistenti personali

Preferenze, task in corso e decisioni vengono conservati come note e riepiloghi, così l'assistente riprende da dove si era fermato.

Piattaforme di agenti

L'agente di ogni cliente ha il proprio namespace su un solo server e non può vedere gli altri.

Integrato

Cosa ottieni

Un insieme di strumenti fisso e sicuro

28 strumenti e nessun modo di eseguire un comando arbitrario. Ogni strumento dichiara se legge, scrive o cancella.

Namespace

--namespace confina un agente in un prefisso che non vede mai. Dai a ogni agente un prefisso che non sia l'inizio di quello di un altro.

Modalità di sola lettura

--read-only non registra nemmeno gli strumenti di scrittura.

Risultati limitati

Valori e liste hanno un limite, così un valore enorme non può inondare il contesto del modello.

Claude Desktop, Cursor e altri client mcpServers

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

Domande frequenti

Quali client funzionano?

Qualsiasi client MCP, compresi Claude Code, Claude Desktop, Cursor e VS Code. Parla stdio per i client locali e HTTP streamable per l'uso condiviso.

Serve una licenza HotKV?

Gli strumenti per chiavi, hash e liste funzionano su qualsiasi server. Gli strumenti per memoria, prompt e ricerca nei documenti usano i motori IA di HotKV, che richiedono una licenza che li includa.

Il trasporto HTTP è autenticato?

No. Tienilo su localhost o dietro un reverse proxy che autentica, e quando puoi dagli un proprio namespace e la modalità di sola lettura.

Casi d'uso correlati

Provalo sul tuo carico di lavoro

HotKV parla il protocollo Redis, quindi puoi puntarci un client esistente ed eseguire questi stessi comandi.