MCP Memory Server

Um sistema de memória avançado para o Claude Desktop que fornece memória persistente usando MCP. Requer uma conta do Azure Cosmos DB e uma chave de API da OpenAI.

GitHub

Experimente este MCPPatrocinado

Documentação

🧠 MCP Memory Server

Sistema Avançado de Memória para Claude Desktop - Transforme o Claude em um assistente de IA com memória fotográfica usando MCP (Model Context Protocol).

✨ O que ele faz

Imagine o Claude com memória persistente que:

🧠 Lembra de tudo das suas conversas
🔍 Recupera contexto automaticamente quando você referencia tópicos passados
🤖 Entende referências como "aquele projeto", "esta empresa", "ele/ela"
📈 Constrói conhecimento ao longo do tempo em todas as suas sessões
🛠️ Captura automaticamente resultados de buscas na web e outras ferramentas

🚀 Início Rápido

Pré-requisitos

Node.js 18+
Conta Azure Cosmos DB
Chave da API OpenAI
Claude Desktop

Instalação

git clone https://github.com/PlumyCat/mcp-memory-server.git
cd mcp-memory-server
npm install
npm run build

Configuração

Configuração do ambiente:

cp .env.example .env
# Edit .env with your API keys

Configuração do Claude Desktop:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/mcp-memory-server/dist/index.js"],
      "cwd": "/path/to/mcp-memory-server"
    }
  }
}

Teste a mágica:

You: "I'm working on a TypeScript project using CosmosDB"
Claude: [Responds normally + automatic background storage]

# Later...
You: "What was that project we discussed?"
Claude: "You mentioned working on a TypeScript project using CosmosDB..."

🎯 Principais Recursos

🧠 Armazenamento Inteligente de Memória

Extração automática de entidades (pessoas, empresas, projetos, ferramentas)
Armazenamento semântico com embeddings da OpenAI
Preservação do contexto da conversa
Deduplicação inteligente

🔍 Busca e Recuperação Avançadas

Busca por similaridade semântica
Mapeamento de relacionamentos entre entidades
Recuperação baseada em linha do tempo
Respostas sensíveis ao contexto

🤖 Resolução de Entidades

Resolução automática de pronomes ("ele" → "John Smith")
Compreensão de referências ("aquela empresa" → "Microsoft")
Vinculação de entidades entre conversas
Pontuação de confiança

📊 Análises e Insights

Análise de padrões de conversa
Linhas do tempo de interação entre entidades
Acompanhamento do crescimento do conhecimento
Estatísticas de uso

🛠️ Ferramentas Disponíveis

O servidor fornece 6 ferramentas MCP para o Claude:

Ferramenta	Descrição	Exemplo de Uso
`memory_store`	Armazena informações com extração automática de entidades	Acionada automaticamente durante conversas
`memory_search`	Busca semântica nas memórias armazenadas	"Encontre todas as discussões sobre React"
`context_inject`	Obtém contexto relevante para a consulta atual	"O que discutimos sobre este projeto?"
`entity_resolve`	Resolve referências para entidades reais	"A quem 'ele' se refere?"
`conversation_analyze`	Analisa padrões de conversa	"Mostre minhas estatísticas de discussão"
`memory_timeline`	Obtém linha do tempo das interações entre entidades	"Linha do tempo das menções à Microsoft"

📁 Estrutura do Projeto

mcp-memory-server/
├── src/
│   ├── config/          # Azure Cosmos DB configuration
│   ├── memory/          # Core memory system (RAG, storage, graph)
│   ├── types/           # TypeScript type definitions
│   ├── utils/           # Entity extraction, context injection
│   └── server.ts        # Main MCP server implementation
├── scripts/             # Maintenance and health check scripts
├── tests/               # Unit and integration tests
├── docs/                # Technical documentation
└── dist/                # Compiled JavaScript (generated)

🏗️ Arquitetura

Componentes Principais

Sistema RAG: Busca por similaridade vetorial com embeddings da OpenAI
Extrator de Entidades: Reconhecimento de entidades baseado em PLN com padrões personalizados
Armazenamento de Memória: Integração otimizada com CosmosDB e indexação inteligente
Injetor de Contexto: Recuperação inteligente de contexto para conversas
Mecanismo de Grafo: Mapeamento e navegação de relacionamentos entre entidades

Fluxo de Dados

graph TD
    A[User Message] --> B[Entity Extraction]
    B --> C[Embedding Generation]
    C --> D[CosmosDB Storage]
    D --> E[Semantic Search]
    E --> F[Context Injection]
    F --> G[Enhanced Claude Response]

🔧 Configuração

Variáveis de Ambiente

# Azure Cosmos DB
COSMOS_ENDPOINT=https://your-account.documents.azure.com:443/
COSMOS_KEY=your-primary-key
COSMOS_DATABASE_NAME=memory-db
COSMOS_CONTAINER_CONVERSATIONS=conversations
COSMOS_CONTAINER_ENTITIES=entities

# OpenAI
OPENAI_API_KEY=your-openai-api-key

# Optional
NODE_ENV=production
LOG_LEVEL=info
MEMORY_RETENTION_DAYS=30

Configuração Avançada

Consulte o Guia de Configuração para opções detalhadas de configuração.

🧪 Testes

# Run all tests
npm test

# Health check
npm run health-check

# Test memory functionality
npm run test-memory

📊 Desempenho

Armazenamento: Indexação otimizada do CosmosDB para consultas abaixo de 100ms
Busca: Similaridade vetorial com precisão de 95%+
Memória: Deduplicação e compressão eficientes de entidades
Escalabilidade: Suporta 1000+ entidades com desempenho consistente

🛣️ Roadmap

✅ Concluído

Armazenamento e recuperação de memória principal
Extração e resolução de entidades
Busca semântica com embeddings
Integração com CosmosDB
Implementação do servidor MCP

🔄 Em Andamento

Deduplicação inteligente de entidades
Captura automática de todos os resultados das ferramentas MCP
Padrões aprimorados de classificação de entidades
Sistema de detecção de contradições

🔮 Planejado

Isolamento de memória para múltiplos usuários
Navegação em grafo com consultas Gremlin
Painel de análises avançadas
Compressão e arquivamento de memória

Consulte o Roadmap para planejamento detalhado de recursos.

🤝 Contribuindo

Aceitamos contribuições! Consulte nossas Diretrizes de Contribuição para mais detalhes.

Configuração de Desenvolvimento

git clone https://github.com/PlumyCat/mcp-memory-server.git
cd mcp-memory-server
npm install
npm run dev

📚 Documentação

Guia de Uso - Exemplos abrangentes de uso
Referência da API - Documentação detalhada da API
Arquitetura - Detalhes técnicos da arquitetura
Solução de Problemas - Problemas comuns e soluções

🆘 Suporte

📖 Consulte o Guia de Uso para exemplos
🐛 Reporte problemas em GitHub Issues
💬 Discuta em GitHub Discussions

📄 Licença

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

🙏 Agradecimentos

Model Context Protocol (MCP) pelo protocolo fundamental
Claude Desktop pela plataforma de assistente de IA
Azure Cosmos DB pelo armazenamento de dados escalável
OpenAI pela geração de embeddings
Compromise.js pelo processamento de linguagem natural

⭐ Histórico de Estrelas

Feito com ❤️ para a comunidade Claude Desktop