memcord

MEMCORD v4.3.6 (servidor mcp)

Este servidor MCP auto-hospedado e focado em privacidade ajuda você a organizar o histórico de conversas, resumir mensagens, pesquisar em conversas passadas com IA — e mantém tudo seguro e totalmente sob seu controle.

Nunca Perca o Contexto Novamente

Transforme suas conversas com Claude em uma base de conhecimento pesquisável e organizada que cresce com você

Novidades na v4.3.6 — remove duas dependências desnecessárias (pandas, python-magic) de uma instalação limpa; a importação CSV/TSV agora usa a biblioteca padrão em vez de pandas.

Sumário

• Benefícios Principais
• Pré-requisitos
• Início Rápido
• Mantendo o Memcord Atualizado
• Usando o Memcord
• Caminho de Armazenamento Personalizado
• Backends de Resumo
• Configuração de IDE
• Documentação

Benefícios Principais

• Memória Infinita - Claude lembra de tudo em conversas ilimitadas com auto-resumo inteligente
• Seus Dados, Seu Controle - Armazenamento 100% local, sem dependências de nuvem ou preocupações com privacidade
• Organização Sem Esforço - Slots de memória por projeto com navegação por linha do tempo e marcação inteligente
• Mesclagem Inteligente - Combina automaticamente conversas relacionadas enquanto elimina duplicatas

Pré-requisitos

Início Rápido

macOS / Linux:

curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash

Windows (PowerShell):

irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex

Isso irá:

• ✅ Baixar e configurar o memcord
• ✅ Configurar o ambiente virtual Python usando uv
• ✅ Gerar arquivos de configuração MCP específicos da plataforma
• ✅ Configurar Claude Desktop, Claude Code, VSCode e Antigravity IDE

Mantendo o Memcord Atualizado

Execute novamente o mesmo comando de instalação do Início Rápido na mesma pasta onde o memcord está instalado — ele detecta uma instalação existente e a atualiza no local, em vez de clonar uma cópia nova:

macOS / Linux:

curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash

Windows (PowerShell):

irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex

Isso irá:

• ✅ Puxar as alterações mais recentes (apenas fast-forward — aborta com segurança se você tiver edições locais)
• ✅ Reutilizar seu ambiente virtual existente e atualizar as dependências
• ✅ Regenerar os arquivos de configuração MCP
• ✅ Deixar seus dados de memória (memory_slots/) e as configurações geradas intactos

cd /path/to/memcord
git pull
uv pip install -e . --upgrade
uv run python scripts/generate-config.py  # Regenerate configs

# Optional: Enable auto-save hooks (new in v2.5.0)
uv run python scripts/generate-config.py --install-hooks

A flag --install-hooks é idempotente — ela mescla no .claude/settings.json existente sem sobrescrever outras configurações ou hooks.

Alternando uma Instalação Existente para o Escopo Global

Instalações novas registram o memcord globalmente (~/.claude.json) por padrão — disponível em todos os projetos. Se você tiver uma instalação mais antiga que ainda está no escopo do projeto (um .mcp.json local), alterne-a explicitamente — executar o atualizador novamente não fará isso por você, pois ele detecta e preserva automaticamente uma configuração existente no escopo do projeto de propósito:

cd /path/to/memcord
uv run python scripts/generate-config.py --scope user

Verifique a partir de um diretório de projeto diferente: claude mcp list agora deve mostrar o memcord. O .mcp.json original é mantido no lugar e ainda funciona (inofensivo, apenas redundante) — exclua-o somente se quiser que esse diretório pare de fixar sua própria cópia local em vez de recorrer à global.

Instalando Comandos de Barra Globalmente

Os 17 comandos de barra memcord-* vêm em .claude/commands/ e já são utilizáveis de dentro do checkout do memcord no momento em que você o clona. Para usá-los a partir de qualquer diretório de projeto, instale-os globalmente em ~/.claude/commands/:

uv run python scripts/generate-config.py --manage-commands   # interactive picker
uv run python scripts/generate-config.py --commands all      # non-interactive: install all

Instalações novas perguntam isso automaticamente (ignorado quando não interativo, ex. curl | bash). Execute novamente a qualquer momento para alterar sua seleção — apenas os próprios arquivos de comando do memcord são adicionados ou removidos.

Usando o Memcord

Configuração Inicial (Novo Projeto)

# 1. Once you are in claude code, initialize the project with a memory slot (one-time setup)
memcord_init "." "my-project-name"
# OR
memcord_init "my_project_name"
# Creates .memcord file containing "my-project-name"

# 2. Start saving your conversations
/memcord-save-progress  # Auto-detects slot from .memcord file

Sessões Posteriores (Retornando ao Projeto)

# Just use slash commands - no slot name needed!
/memcord-read           # Reads from bound slot
/memcord-save           # Saves to bound slot
/memcord-save-progress  # Summarizes and saves

Pesquisa e Consulta (Chamadas Diretas de Ferramentas)

memcord_select_entry "2 hours ago"    # Jump to a point in the timeline
memcord_list                          # List all slots
memcord_search "API design"           # Full-text search
memcord_query "What did we decide?"   # Natural language query

Consulte Referência Completa de Ferramentas para todas as 23 ferramentas com parâmetros completos e exemplos.

Como Funciona a Detecção Automática

Todas as operações de leitura e escrita seguem a mesma prioridade de resolução de slot:

1. Argumento slot_name explícito (sempre vence)
2. Slot atualmente ativo (definido por memcord_use ou memcord_name)
3. Arquivo de vínculo .memcord no diretório de trabalho atual

Quando o vínculo .memcord é usado e o slot já existe, ele também é auto-ativado para o restante da sessão — então as operações subsequentes pulam a redetecção automaticamente.

Isso significa que após memcord_init, uma sessão nova (sem chamada memcord_use necessária) roteará corretamente memcord_save, memcord_save_progress, memcord_configure e memcord_read para o slot vinculado.

Caminho de Armazenamento Personalizado

Aponte o arquivo de dados de um slot para qualquer diretório — ex. uma pasta Dropbox/OneDrive — para compartilhá-lo entre dispositivos, via memcord_configure. Uma vez vinculado, as configurações do slot (backend de resumo, etc.) viajam com os dados também, então todo dispositivo que compartilha a pasta vê a mesma configuração.

Nova memória em um caminho externo:

memcord_name "shared_slot"
memcord_configure action="set" key="custom_storage_path" value="D:\Dropbox\shared"
memcord_save "..."   # writes directly to the external path

Migrar uma memória existente:

memcord_configure action="set" key="custom_storage_path" value="D:\Dropbox\shared"
# Existing data is moved automatically — memcord_read/memcord_list keep working

Cada dispositivo precisa executar o comando set uma vez com seu próprio caminho local para a pasta compartilhada. Consulte Referência de Ferramentas — memcord_configure para detalhes de migração/colisão.

Backends de Resumo

O Memcord suporta quatro backends de resumo plugáveis (nltk, sumy, semantic, transformers), alternáveis por slot via memcord_configure action="set" key="summarizer_backend" value="..." — sem necessidade de reiniciar. Novos slots usam sumy por padrão (sem downloads); slots existentes mantêm nltk para compatibilidade retroativa.

Consulte Referência de Ferramentas — memcord_configure e Guia de Recursos para a comparação completa dos backends, instruções de instalação e a substituição pela variável de ambiente MEMCORD_SUMMARIZER.

Configuração de IDE

O instalador configura automaticamente todos os IDEs suportados. Para configuração manual ou solução de problemas, consulte os guias detalhados:

Instalação Manual

git clone https://github.com/ukkit/memcord.git
cd memcord
uv venv && uv pip install -e .
uv run python scripts/generate-config.py

Consulte o Guia Completo de Instalação para atualização, opções avançadas e comandos personalizados.

Documentação

Se você achar este projeto útil, considere:

• ⭐ Dar uma estrela no repositório no GitHub
• ☕ Apoiar o Desenvolvimento
• 🐛 Relatar bugs e sugerir recursos

Licença MIT — consulte o arquivo LICENSE para detalhes.