memory-mcp

🧠 Servidor MCP de Memória

Memória persistente e cache de janela de contexto para conversas com LLM. Salve, recupere e gerencie memórias com arquivamento inteligente de contexto. Armazenamento com MongoDB.

Um servidor MCP (Model Context Protocol) que fornece gerenciamento de memória e cache de janela de contexto para ambientes de codificação com IA, como Cursor e Claude Desktop.

Por que usar o Memory MCP?

• 💾 Armazenamento Persistente – Memória com MongoDB que sobrevive às sessões
• 🧠 Cache de Contexto – Arquivamento e recuperação inteligentes do contexto da conversa
• 🏷️ Busca por Tags – Organize e encontre memórias por tags
• 📊 Pontuação de Relevância – Pontue automaticamente a relevância do conteúdo arquivado
• ⚡ Configuração Fácil – Instalação com um clique no Cursor ou configuração manual simples

Início Rápido

Pronto para adicionar memória ao seu fluxo de trabalho com IA? Instale em segundos:

Instalar no Cursor (Recomendado):

🔗 Instalar no Cursor

Ou instale manualmente:

npm install -g @jamesanz/memory-mcp
# Or from source:
git clone https://github.com/JamesANZ/memory-mcp.git
cd memory-mcp && npm install && npm run build

Recursos

Ferramentas Básicas de Memória

• save-memories – Salva memórias no banco de dados (substitui as existentes)
• get-memories – Recupera todas as memórias armazenadas
• add-memories – Adiciona novas memórias sem substituir as existentes
• clear-memories – Remove todas as memórias armazenadas

Cache de Janela de Contexto

• archive-context – Arquiva o contexto da conversa com tags
• retrieve-context – Recupera o contexto arquivado relevante
• score-relevance – Pontua a relevância do conteúdo arquivado
• create-summary – Cria resumos do conteúdo arquivado
• get-conversation-summaries – Obtém todos os resumos de uma conversa
• search-context-by-tags – Busca conteúdo arquivado por tags

Instalação

Cursor (Um Clique)

Clique no link de instalação acima ou use:

cursor://anysphere.cursor-deeplink/mcp/install?name=memory-mcp&config=eyJtZW1vcnktbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiQGphbWVzYW56L21lbW9yeS1tY3AiXX19

Instalação Manual

Requisitos: Node.js 18+, npm, MongoDB

# Clone and build
git clone https://github.com/JamesANZ/memory-mcp.git
cd memory-mcp
npm install
npm run build

# Set MongoDB connection string
export MONGODB_URI="mongodb://localhost:27017"

# Run server
npm start

Claude Desktop

Adicione em claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memory-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/memory-mcp/build/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017"
      }
    }
  }
}

Reinicie o Claude Desktop após a configuração.

Configuração

Defina a string de conexão do MongoDB:

export MONGODB_URI="mongodb://localhost:27017"

Padrão: mongodb://localhost:27017

Exemplos de Uso

Salvar Memórias

Armazene memórias de uma conversa:

{
  "tool": "save-memories",
  "arguments": {
    "memories": ["User prefers TypeScript", "User works on blockchain projects"],
    "llm": "claude",
    "userId": "user123"
  }
}

Recuperar Memórias

Obtenha todas as memórias armazenadas:

{
  "tool": "get-memories",
  "arguments": {}
}

Arquivar Contexto

Arquive o contexto da conversa quando ele ficar muito longo:

{
  "tool": "archive-context",
  "arguments": {
    "conversationId": "conv-123",
    "contextMessages": ["Message 1", "Message 2"],
    "tags": ["coding", "typescript"],
    "llm": "claude"
  }
}

Recuperar Contexto Relevante

Obtenha o conteúdo arquivado relevante para a conversa atual:

{
  "tool": "retrieve-context",
  "arguments": {
    "conversationId": "conv-123",
    "tags": ["coding"],
    "minRelevanceScore": 0.5,
    "limit": 10
  }
}

Cache de Janela de Contexto

O sistema automaticamente:

• Arquiva conteúdo quando o uso do contexto atinge 80%
• Recupera conteúdo relevante quando o uso cai abaixo de 30%
• Pontua a relevância usando sobreposição de palavras-chave
• Cria resumos para condensar conversas longas

Casos de Uso

• Conversas Longas – Gerencie janelas de contexto para sessões estendidas
• Persistência de Memória – Salve informações importantes entre sessões
• Recuperação de Contexto – Traga de volta conversas passadas relevantes
• Projetos de Pesquisa – Organize e marque conversas de pesquisa com tags

Detalhes Técnicos

Construído com: Node.js, TypeScript, MCP SDK, MongoDB
Dependências: @modelcontextprotocol/sdk, mongodb, zod
Plataformas: macOS, Windows, Linux

Armazenamento: MongoDB (padrão: mongodb://localhost:27017)

Contribuição

⭐ Se este projeto ajudar você, dê uma estrela no GitHub! ⭐

Contribuições são bem-vindas! Abra uma issue ou envie um pull request.

Licença

ISC

Suporte

Se você achar este projeto útil, considere apoiá-lo:

⚡ Lightning Network

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f