MemFlow MCP

Permite que Grandes Modelos de Linguagem armazenem e recuperem memórias persistentes com capacidades de busca inteligente.

Documentação

memflow-mcp

Um servidor Model Context Protocol (MCP) que permite que Modelos de Linguagem de Grande Porte armazenem e recuperem memórias persistentes com recursos inteligentes de busca.

Descrição

O MemFlow MCP fornece integração perfeita entre LLMs como Claude e sua API Memory Bank, permitindo gerenciamento persistente de memória entre conversas. O servidor suporta adicionar memórias com tags, busca semântica e recuperação flexível de memórias.

Instalação

npx memflow-mcp

Ou instale globalmente:

pnpm add -g memflow-mcp

Configuração

Variáveis de Ambiente

MEMBANK_API_URL=http://localhost:3000
MEMBANK_API_KEY=your-api-key  # optional

Claude Desktop

Consulte CLAUDE_DESKTOP_CONFIG.md para opções de configuração detalhadas para diferentes instalações do Node.js.

Início rápido - Encontre o caminho do seu npx e use-o:

which npx

Em seguida, configure o Claude Desktop:

{
  "mcpServers": {
    "memflow": {
      "command": "/your/npx/path",
      "args": ["-y", "memflow-mcp"],
      "env": {
        "MEMBANK_API_URL": "http://localhost:3000"
      }
    }
  }
}

Ferramentas Disponíveis

  • addMemory - Armazena conteúdo com tags opcionais
  • searchMemory - Busca memórias com correspondência semântica
  • listMemories - Navega pelas memórias armazenadas com filtros

Uso

Uma vez configurado, você pode usar estes comandos no Claude:

Add this to memory: "Claude can now remember things across conversations"

Search my memories for "conversations"

List my recent memories

Requisitos

  • Node.js 18+
  • Servidor da API Memory Bank em execução

Solução de Problemas

Erro "spawn npx ENOENT"

  1. Encontre o caminho do seu npx:

    which npx
    

    Use este caminho completo na configuração do seu Claude Desktop.

  2. Caminhos comuns:

    • asdf: /Users/username/.asdf/shims/npx
    • Homebrew (Intel): /usr/local/bin/npx
    • Homebrew (Apple Silicon): /opt/homebrew/bin/npx
    • Sistema: /usr/bin/npx
  3. Teste se funciona:

    /your/npx/path -y memflow-mcp
    

Erros JSON "Unexpected token"

  • Certifique-se de que MEMBANK_API_URL está definido corretamente
  • Verifique se a sua API Memory Bank está em execução
  • Reinicie o Claude Desktop após alterações na configuração

Endpoints da API

Sua API Memory Bank deve suportar:

  • POST /memory - Criar memória
  • GET /memory - Listar/buscar memórias

Licença

MIT