Claude Memory MCP Server

Claude Memory MCP Server

Uma implementação de servidor MCP (Model Context Protocol) que fornece capacidades de memória persistente para Modelos de Linguagem de Grande Porte, especificamente projetada para integrar com o aplicativo de desktop Claude.

Visão Geral

Este projeto implementa técnicas ótimas de memória baseadas em pesquisa abrangente das abordagens atuais no campo. Ele fornece uma maneira padronizada para o Claude manter memória persistente entre conversas e sessões.

Recursos

• Arquitetura de Memória em Camadas: Camadas de memória de curto prazo, longo prazo e arquivamento
• Múltiplos Tipos de Memória: Suporte para conversas, conhecimento, entidades e reflexões
• Busca Semântica: Recupere memórias com base em similaridade semântica
• Gerenciamento Automático de Memória: Captura inteligente de memória sem comandos explícitos
• Consolidação de Memória: Consolidação automática de memórias de curto prazo em memória de longo prazo
• Gerenciamento de Memória: Retenção e esquecimento de memórias baseados em importância
• Integração com Claude: Integração pronta para uso com o aplicativo de desktop Claude
• Suporte ao Protocolo MCP: Compatível com o Model Context Protocol
• Suporte a Docker: Implantação fácil usando contêineres Docker

Início Rápido

Opção 1: Usando Docker (Recomendado)

# Clone the repository
git clone https://github.com/WhenMoon-afk/claude-memory-mcp.git
cd claude-memory-mcp

# Start with Docker Compose
docker-compose up -d

Configure o Claude Desktop para usar o servidor MCP conteinerizado (veja o Guia de Uso do Docker para detalhes).

Opção 2: Instalação Padrão

1. Pré-requisitos:

   • Python 3.8-3.12
   • Gerenciador de pacotes pip

2. Instalação:

   # Clone the repository
   git clone https://github.com/WhenMoon-afk/claude-memory-mcp.git
   cd claude-memory-mcp
   
   # Install dependencies
   pip install -r requirements.txt
   
   # Run setup script
   chmod +x setup.sh
   ./setup.sh
   

3. Integração com Claude Desktop:

   Adicione o seguinte ao seu arquivo de configuração do Claude:

   {
     "mcpServers": {
       "memory": {
         "command": "python",
         "args": ["-m", "memory_mcp"],
         "env": {
           "MEMORY_FILE_PATH": "/path/to/your/memory.json"
         }
       }
     }
   }
   

Usando Memória com o Claude

O Memory MCP Server permite que o Claude lembre informações entre conversas sem exigir comandos explícitos.

1. Memória Automática: O Claude automaticamente irá:

   • Lembrar detalhes importantes que você compartilha
   • Armazenar preferências e fatos do usuário
   • Recuperar informações relevantes quando necessário

2. Recuperação de Memória: Para ver o que o Claude lembra, basta perguntar:

   • "O que você lembra sobre mim?"
   • "O que você sabe sobre minhas preferências?"

3. Prompt do Sistema: Para uso ótimo da memória, adicione isto ao seu prompt de sistema do Claude:

   This Claude instance has been enhanced with persistent memory capabilities.
   Claude will automatically remember important details about you across
   conversations and recall them when relevant, without needing explicit commands.
   

Veja o Guia do Usuário para instruções detalhadas de uso e exemplos.

Documentação

• Guia do Usuário
• Guia de Uso do Docker
• Guia de Compatibilidade
• Arquitetura
• Guia de Integração com Claude

Exemplos

O diretório examples contém scripts que demonstram como interagir com o Memory MCP Server:

• store_memory_example.py: Exemplo de armazenamento de uma memória
• retrieve_memory_example.py: Exemplo de recuperação de memórias

Solução de Problemas

Se você encontrar problemas:

1. Verifique o Guia de Compatibilidade para requisitos de dependências
2. Certifique-se de que sua versão do Python seja 3.8-3.12
3. Para problemas com NumPy, use: pip install "numpy>=1.20.0,<2.0.0"
4. Tente usar Docker para implantação simplificada

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto é licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.