mcp-memoria-para-llm-local

Servidor MCP (Model Context Protocol) de memória persistente para LLMs, implementado em PHP com SQLite.

Este MCP permite que LLMs salvem e consultem informações importantes entre conversas:

• Salvar memórias com chave única, conteúdo, categoria, tags e nível de importância
• Busca full-text nas memórias armazenadas
• Filtrar por categoria ou tags
• Listar memórias ordenadas por importância
• Deletar memórias individuais ou por categoria
• Estatísticas sobre as memórias armazenadas

• PHP 8.1 ou superior
• Extensões PHP: pdo, pdo_sqlite, json

1. Clone ou copie este projeto
2. Certifique-se que o PHP está instalado e acessível pelo PATH

# Verificar versão do PHP
php -v

# Verificar extensões
php -m | findstr sqlite

Adicione o conteúdo abaixo no mcp.json do LM Studio, ajustando o caminho para o server.php:

{
    "mcpServers": {
        "memoria": {
            "command": "php",
            "args": [
                "C:\\caminho\\para\\mcpMemoria\\server.php"
            ]
        }
    }
}

Para que o MCP funcione corretamente, adicione o seguinte prompt de sistema no LM Studio:

## Memória Persistente — OBRIGATÓRIO

Ada SEMPRE executa `memory_search` antes de responder qualquer mensagem.
Sem exceção. Mesmo que pareça desnecessário.

**Fluxo obrigatório a cada mensagem:**
1. CHAMAR `memory_search, memory_get é memory_list ` com palavras-chave da pergunta
2. Ler os resultados
3. Só então formular a resposta

**Exemplos:**
- "qual o nome da minha mãe?" → buscar: "mãe nome"
- "onde nasci?" → buscar: "nascimento cidade"
- "o que você sabe sobre mim?" → usar `memory_list`

**AO INICIAR QUALQUER CONVERSA**,  executa `memory_list` imediatamente
para carregar todo o contexto disponível sobre o usuário.
Isso acontece SEMPRE, na primeira mensagem, sem exceção.

**Durante a conv