LocalKeep

Você decide o que Claude lembra sobre você. LocalKeep é uma linha do tempo pessoal que você organiza—bancos intitulados, datados e editáveis na sua máquina—e o Claude os consulta via MCP em vez de inventar uma memória de nuvem inalterável.

GitHub
2
Experimente este MCPPatrocinado

Documentação

LocalKeep

O LocalKeep é para qualquer pessoa que queira uma camada de memória cronológica para chatbots, onde eles controlam diretamente o que o modelo lembra sobre eles. Em vez de forçar você a depender de uma memória em nuvem de caixa-preta que o modelo inventa sobre você e que você nem consegue editar, o LocalKeep permite que você organize bancos de memória intitulados, datados e editáveis diretamente na sua própria máquina, onde você escreve as entradas e as gerencia localmente por meio de uma interface Hub localhost. Quando uma conversa exige seu contexto anterior, o Claude consulta seus dados locais por meio de um conector seguro e nativo do Model Context Protocol (MCP).

Por que usar o LocalKeep

Os aplicativos de chat com IA são ótimos em parecer que lembram de você, mas têm dificuldade em recuperar a coisa exata que você se importa — o que aconteceu, em qual data, sobre quem? Os recursos de memória para consumidores tendem a não ter capacidade de raciocínio temporal real, achatando seu histórico em um resumo genérico e vago, em vez de entender que o Evento A desencadeou o Evento B há três meses, fazendo com que o raciocínio falhe quando você precisa de algo específico: um evento de vida, um arco de pesquisa, uma decisão que você registrou meses atrás. Pior ainda, a memória de IA para consumidores é uma caixa-preta: você não decide o que o modelo escolhe lembrar sobre você, como ele interpreta sua vida ou quando ele inventa contexto ao seu redor.

LocalKeep corrige ambas as falhas estruturais de uma vez, substituindo linhas do tempo frágeis e inventadas pelo modelo por uma fonte rígida e cronológica da sua verdade, tudo isso dando a você controle editorial absoluto. Você decide exatamente o que a IA pode saber sobre você. Você escreve as entradas, ancora as datas e as mantém localmente na sua própria máquina. O Claude simplesmente atua como o mecanismo de consulta via MCP quando uma conversa exige seu contexto anterior. O LocalKeep preenche a lacuna entre o registro pessoal estruturado e a recuperação inteligente por IA, garantindo que seu contexto seja curado por você — não alucinado por um LLM.

Para quem é

  • Qualquer pessoa frustrada por a memória do chat não conseguir buscar fatos datados de forma confiável ou entender linhas do tempo
  • Pessoas que já mantêm diários pessoais meticulosos, registros de trabalho ou arquivos de pesquisa. Em vez de se contentar com uma paráfrase genérica de aplicativo de chat, você pode injetar suas exatas palavras e dados históricos no prompt como uma fonte inabalável de verdade.
  • Usuários que confiam no Claude por sua capacidade de raciocínio, mas exigem que seu banco de dados de contexto fundamental permaneça armazenado localmente, sob seu próprio teto. (Nota: consultar memórias via MCP ainda envia os fragmentos de texto recuperados para a Anthropic durante a sessão).

O que é (e o que não é)

  • É: Uma interface Hub local leve e personalizável para gerenciar seus bancos de memória datados, emparelhada com um servidor MCP que o Claude Desktop pode chamar.
  • Não é: Um aplicativo de chat independente, uma API de memória hospedada em nuvem ou um utilitário em segundo plano que coleta silenciosamente suas conversas pessoais.

A Filosofia Estética

A interface Hub adota intencionalmente uma homenagem retrô inspirada no Windows 95/MS Paint, com recursos personalizáveis para garantir que o LocalKeep pareça uma ferramenta profundamente pessoal em vez de um painel rígido e impessoal. Ao colocar elementos de interface ajustáveis ao seu alcance, a interface sinaliza que você está entrando em uma oficina offline e íntima para sua mente — um espaço que você pode moldar e reconfigurar para parecer totalmente seu.

Instalação

pip install localkeep
# or: uv tool install localkeep

Em seguida:

localkeep-hub          # http://127.0.0.1:8000

No Claude Desktop, registre o servidor MCP (claude_desktop_config.json):

{
  "mcpServers": {
    "localkeep": {
      "command": "localkeep-mcp",
      "args": []
    }
  }
}

Se a interface gráfica não encontrar localkeep-mcp no seu PATH, use o caminho absoluto de which localkeep-mcp (o painel Connect do Hub copia isso para você).

As memórias ficam por padrão em ~/.localkeep/localkeep.db quando instaladas via pip. Substitua com LOCALKEEP_DATA_DIR ou LOCALKEEP_DB_PATH.

Uso automático do LocalKeep (importante)

O Claude não chamará as ferramentas MCP de forma confiável a menos que você também defina Preferências pessoais:

  1. Claude Desktop → Configurações → Perfil → Preferências pessoais
  2. Cole as instruções do LocalKeep (Hub → Connect → Copiar instruções, ou veja src/localkeep/assets/claude-personal-preferences.txt)
  3. Saia completamente do Claude e reabra
  4. Quando o LocalKeep pedir para executar uma ferramenta, clique em Sempre aprovar

Desenvolver a partir do código-fonte

git clone https://github.com/zuneracodes/localkeep
cd localkeep
uv sync --group dev
uv run localkeep-hub                     # http://127.0.0.1:8000
# optional live reload:
LOCALKEEP_HUB_RELOAD=1 uv run localkeep-hub

A partir de um checkout do código-fonte, o banco de dados fica em data/localkeep.db (ignorado pelo git).

Testes

Estes verificam rapidamente o Hub, a recuperação e as ferramentas MCP para que uma instalação nova ainda armazene e recupere memórias datadas da maneira que um usuário real faria.

uv sync --group dev
uv run pytest

Os testes começam com um banco de dados vazio e criam memórias por meio de POSTs de formulário do Hub (mesmo caminho de um novo usuário).

Privacidade

O armazenamento é local. Bancos e memórias ficam no caminho do banco de dados que você escolher (~/.localkeep/ para instalações via pip, ou data/localkeep.db em um checkout). Não existe nuvem do LocalKeep e nada é coletado automaticamente do chat. As cores do tema permanecem no navegador localStorage. Atualizar a página do Hub ou reiniciar o localkeep-hub não exclui seus bancos — apenas a remoção do arquivo do banco de dados faz isso.

A recuperação passa pelo Claude. O Hub e o banco de dados permanecem na sua máquina, mas quando o Claude chama uma ferramenta MCP do LocalKeep, as memórias correspondentes são retornadas para esse chat e a Anthropic as processa como qualquer outro resultado de ferramenta. O LocalKeep não envia todo o seu banco de dados para o servidor — apenas o que essa consulta retorna para a pergunta em questão.

Contribuindo

Relatórios de bugs e pull requests são bem-vindos via GitHub Issues. Execute uv run pytest antes de abrir um PR.

Licença

MIT — veja LICENSE.