IA e LLMAgentes

Memória para assistentes de IA via MCP

Dê ao Claude, ao Cursor, ao VS Code ou ao seu próprio agente memória, notas, um log de eventos, templates de prompts e busca em documentos, por meio de um servidor MCP.

ferramentas fixas
28
comandos arbitrários
0
open source
Apache-2.0
Etapa 1 de 5
Conecte o servidor

Um comando adiciona o HotKV ao Claude Code. O Cursor e o Claude Desktop usam uma entrada mcpServers.

Sessão de exemploplaying
# Conecte o servidor
$ claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace team-docs
(hotkv added as an MCP server)

Uma demonstração animada com comandos reais do HotKV e respostas de exemplo. Clique em qualquer etapa para ir direto a ela. Os comandos e as respostas ficam em inglês, exatamente como você os digita e vê no HotKV.

O problema

Os assistentes de IA esquecem tudo quando o chat termina, e dar a eles acesso direto ao banco de dados para resolver isso é perigoso. Um único comando errado de um modelo pode apagar dados ou ler as chaves de outro tenant.

Como o HotKV resolve

O hotkv-mcp dá a um assistente um conjunto fixo de 28 ferramentas para chaves, hashes e listas, memória de conversa, notas de trabalho, um log de eventos, resumos contínuos, um registro de prompts e busca em documentos. Não existe ferramenta que execute um comando arbitrário, um namespace confina o agente a um prefixo e o modo somente leitura remove todas as ferramentas de escrita.

Passo a passo

O que acontece, comando por comando

  1. 01

    Conecte o servidor

    Um comando adiciona o HotKV ao Claude Code. O Cursor e o Claude Desktop usam uma entrada mcpServers.

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

    "Lembre do nosso checklist de release"

    O assistente salva uma nota de trabalho com a ferramenta memory_set_note. Ela fica sob o prefixo team-docs.

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

    Na semana seguinte, em um chat novo

    Uma conversa nova não tem histórico, mas a nota continua no HotKV.

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

    Pesquise os documentos do time

    Os documentos ingeridos com rag_ingest são pesquisados por relevância de palavras-chave, sem precisar de modelo de embedding.

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

    Os outros times ficam fora de alcance

    Todo nome é armazenado sob team-docs:, então isto aponta para team-docs:other-team:secrets, que não existe. As chaves de outro time não podem nem ser nomeadas, e nenhuma ferramenta apaga o banco de dados ou executa comandos diretos.

    tool delete {"key": "other-team:secrets"}
Onde se encaixa

Cenários reais

Times de engenharia

Um servidor MCP compartilhado e somente leitura permite que o assistente de cada desenvolvedor pesquise os mesmos runbooks e notas de design.

Assistentes pessoais

Preferências, tarefas em andamento e decisões ficam guardadas como notas e resumos, então o assistente continua de onde parou.

Plataformas de agentes

O agente de cada cliente recebe o próprio namespace em um servidor e não consegue ver os outros.

Integrado

O que você ganha

Um conjunto de ferramentas fixo e seguro

28 ferramentas e nenhuma forma de executar um comando arbitrário. Cada ferramenta declara se lê, grava ou apaga.

Namespaces

--namespace confina um agente a um prefixo que ele nunca vê. Dê a cada agente um prefixo que não seja o começo do prefixo de outro.

Modo somente leitura

Com --read-only, as ferramentas de escrita nem são registradas.

Resultados limitados

Valores e listas têm um teto, então um valor enorme não consegue inundar o contexto do modelo.

Claude Desktop, Cursor e outros clientes mcpServers

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

Perguntas frequentes

Quais clientes funcionam com ele?

Qualquer cliente MCP, incluindo Claude Code, Claude Desktop, Cursor e VS Code. Ele fala stdio para clientes locais e HTTP com streaming para uso compartilhado.

Ele precisa de uma licença do HotKV?

As ferramentas de chaves, hashes e listas funcionam em qualquer servidor. As ferramentas de memória, prompts e busca em documentos usam os motores de IA do HotKV, que precisam de uma licença que os inclua.

O transporte HTTP é autenticado?

Não. Mantenha-o no localhost ou atrás de um proxy reverso que faça autenticação, e dê a ele o próprio namespace e o modo somente leitura sempre que possível.

Casos de uso relacionados

Experimente com a sua própria carga de trabalho

O HotKV fala o protocolo Redis, então você pode apontar um cliente existente para ele e executar estes mesmos comandos.