Memory Custom

Memory Custom

Este projeto adiciona novos recursos ao servidor Memory oferecido pela equipe MCP. Ele permite a criação e o gerenciamento de um grafo de conhecimento que captura interações por meio de um modelo de linguagem (LLM).

Novos Recursos

1. Caminhos de Memória Personalizados

• Os usuários agora podem especificar diferentes caminhos de arquivo de memória para vários projetos.
• Por quê?: Este recurso melhora a organização e o gerenciamento dos dados de memória, permitindo armazenamento de memória específico por projeto.

2. Registro de Data e Hora

• O servidor agora gera registros de data e hora para as interações.
• Por quê?: Os registros de data e hora permitem rastrear quando cada memória foi criada ou modificada, fornecendo melhor contexto e histórico para os dados armazenados.

Começando

Pré-requisitos

• Node.js (versão 16 ou superior)

Instalação via Smithery

Para instalar o Knowledge Graph Memory Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @BRO3886/mcp-memory-custom --client claude

Instalação

1. Clone o repositório:

   git clone git@github.com:BRO3886/mcp-memory-custom.git
   cd mcp-memory-custom
   

2. Instale as dependências:

   npm install
   

Configuração

Antes de executar o servidor, você pode definir a variável de ambiente MEMORY_FILE_PATH para especificar o caminho do arquivo de memória. Se não for definida, o servidor usará por padrão memory.json no mesmo diretório do script.

Executando o Servidor

Atualizando o arquivo json do servidor mcp

Adicione isto ao seu arquivo claude_desktop_config.json / .cursor/mcp.json:

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

Alterações no Prompt do Sistema:

Follow these steps for each interaction:
1. The memoryFilePath for this project is /path/to/memory/project_name.json - always pass this path to the memory file operations (when creating entities, relations, or retrieving memory etc.)
2. User Identification:
   - You should assume that you are interacting with default_user
   - If you have not identified default_user, proactively try to do so.

3. Memory Retrieval:
   - Always begin your chat by saying only "Remembering..." and retrieve all relevant information from your knowledge graph
   - Always refer to your knowledge graph as your "memory"

4. Memory
   - While conversing with the user, be attentive to any new information that falls into these categories:
     a) Basic Identity (age, gender, location, job title, education level, etc.)
     b) Behaviors (interests, habits, etc.)
     c) Preferences (communication style, preferred language, etc.)
     d) Goals (goals, targets, aspirations, etc.)
     e) Relationships (personal and professional relationships up to 3 degrees of separation)

5. Memory Update:
   - If any new information was gathered during the interaction, update your memory as follows:
     a) Create entities for recurring organizations, people, and significant events, add timestamps to wherever required. You can get current timestamp via get_current_time
     b) Connect them to the current entities using relations
     c) Store facts about them as observations, add timestamps to observations via get_current_time


IMPORTANT: Provide a helpful and engaging response, asking relevant questions to encourage user engagement. Update the memory during the interaction, if required, based on the new information gathered (point 4).

Executando o Servidor Localmente

Para iniciar o Knowledge Graph Memory Server, execute:

npm run build
node dist/index.js

O servidor ficará ouvindo solicitações via entrada/saída padrão.

Endpoints da API

O servidor expõe várias ferramentas que podem ser chamadas com parâmetros específicos:

• Obter Hora Atual
• Definir Caminho do Arquivo de Memória
• Criar Entidades
• Criar Relações
• Adicionar Observações
• Excluir Entidades
• Excluir Observações
• Excluir Relações
• Ler Grafo
• Pesquisar Nós
• Abrir Nós

Agradecimentos

• Inspirado no servidor Memory da Anthropic.