Memory-Plus

Memory-Plus

Um armazenamento de memória leve e local de Geração Aumentada por Recuperação (RAG) para agentes MCP. O Memory-Plus permite que seu agente registre, recupere, atualize e visualize "memórias" persistentes—notas, ideias e contexto de sessão—entre execuções.

🏆 Primeiro Lugar no Infosys Cambridge AI Centre Hackathon!

Principais Recursos

• Registrar Memórias：Salve dados do usuário, ideias e contexto importante.
• Recuperar Memórias：Pesquise por palavras-chave ou tópicos em entradas passadas.
• Memórias Recentes：Obtenha rapidamente os últimos N itens.
• Atualizar Memórias：Anexe ou modifique entradas existentes sem problemas.
• Visualizar Memórias：Clusters de gráfico interativos que revelam relacionamentos.
• Importação de Arquivos (desde v0.1.2)：Ingira documentos diretamente na memória.
• Excluir Memórias (desde v0.1.2)：Remova entradas indesejadas.
• Memória para Memórias (desde v0.1.4)：Agora usamos resources para ensinar sua IA exatamente quando (e quando não) recordar interações passadas.
• Versionamento de Memórias (desde v0.1.4)：Quando as memórias são atualizadas, mantemos as versões antigas para fornecer um histórico completo.

Instalação

1. Pré-requisitos

Chave de API do Google Obtenha no Google AI Studio e defina como GOOGLE_API_KEY no seu ambiente.

Observe que usaremos apenas o Gemini Embedding API com esta chave de API, então é Totalmente Gratuito para você usar!

# macOS/Linux
export GOOGLE_API_KEY="<YOUR_API_KEY>"

# Windows (PowerShell)
setx GOOGLE_API_KEY "<YOUR_API_KEY>"

Runtime UV Necessário para servir o plugin MCP.

pip install uv

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configuração em um Clique no VS Code

Clique no selo abaixo para instalar e configurar automaticamente o Memory-Plus no VS Code:

Isso adicionará o seguinte ao seu settings.json:

  {
    "mcpServers": {
      //...,  your other MCP servers
      "memory-plus": {
        "command": "uvx",
        "args": [
          "-q",
          "memory-plus@latest"
        ],
      }
    }
  }

Para cursor, vá para file -> Preferences -> Cursor Settings -> MCP e adicione a configuração acima. Se você não adicionou o GOOGLE_API_KEY aos seus segredos / variáveis de ambiente, pode adicioná-lo com:

"env": {
        "GOOGLE_API_KEY": "<YOUR_API_KEY>"
      }

logo após a matriz args dentro do dicionário memory-plus.

Para Cline, adicione o seguinte ao seu cline_mcp_settings.json:

{
  "mcpServers": {
    //...,  your other MCP servers
    "memory-plus": {
      "disabled": false,
      "timeout": 300,
      "command": "uvx",
      "args": [
        "-q",
        "memory-plus@latest"
      ],
      "env": {
        "GOOGLE_API_KEY": "${{ secrets.GOOGLE_API_KEY }}"
      },
      "transportType": "stdio"
    }
  }
}

Para outros IDEs, deve ser bem semelhante ao acima.

Testes e Desenvolvimento Local

Usando o MCP Inspector, você pode testar o servidor memory-plus localmente.

git clone https://github.com/Yuchen20/Memory-Plus.git
cd Memory-Plus
npx @modelcontextprotocol/inspector fastmcp run run .\\memory_plus\\mcp.py

Ou, se preferir usar este MCP em uma sessão de chat real, há um chatbot de modelo em agent.py.

# Clone the repository
git clone https://github.com/Yuchen20/Memory-Plus.git
cd Memory-Plus

# Install dependencies
pip install uv
uv pip install fast-agent-mcp
uv run fast-agent setup        

configure o fastagent.config.yaml e o fastagent.secrets.yaml com suas próprias chaves de API.

# Run the agent
uv run agent_memory.py

RoadMap

• Atualização de Memória
• Engenharia de prompt aprimorada para registro de memória
• Melhor Visualização do Gráfico de Memória
• Importação de Arquivos
• Backup remoto!
• Interface Web para Gerenciamento de Memória

Se você tiver alguma solicitação de recurso, sinta-se à vontade para adicioná-la criando uma nova issue ou adicionando uma nova entrada no Pedido de Recurso

Licença

Este projeto é licenciado sob a Apache License 2.0. Consulte LICENSE para obter detalhes.

FAQ

1. Por que o memory-plus não está funcionando?

• O memory-plus tem algumas dependências que podem ser lentas para baixar na primeira vez. Normalmente leva cerca de 1 minuto para buscar tudo o que é necessário.
• Depois que as dependências são instaladas, o uso subsequente será muito mais rápido.
• Se você tiver outros problemas, sinta-se à vontade para abrir uma nova issue no repositório.

2. Como uso o memory-plus em uma sessão de chat real?

• Basta adicionar o arquivo JSON do MCP à sua configuração MCP.
• Depois de adicionado, o memory-plus será ativado automaticamente quando necessário.