mcp-memory: SQLite FTS5 + OKF do Google para Memória Rápida de Agentes

Procurando uma forma de dar memória persistente ao seu agente de codificação de IA sem depender de um banco de dados vetorial pesado? mcp-memory é um servidor MCP open-source que armazena a memória do agente como arquivos Markdown no formato OKF v0.2 do Google, indexa tudo localmente com SQLite FTS5 e expõe quatro ferramentas MCP limpas. Ele foi projetado para ser integrado ao Claude Desktop, Cursor, Antigravity, Windsurf ou Codex com um assistente de configuração sem complicação.

O que ele faz

mcp-memory mantém uma arquitetura de duas camadas:

• Diretório OKF legível por humanos: Cada memória é gravada como um arquivo .md bruto dentro de memory/, com um index.md raiz (versionado com okf_version: "0.2") e um log.md para o histórico de atualizações.
• Índice SQLite FTS5: A busca em texto completo e os gatilhos mantêm consultas de chave abaixo de 20ms e buscas por palavras-chave instantâneas.

As memórias são armazenadas como documentos Markdown OKF v0.2 com frontmatter YAML (type, key, namespace, tags, generated, sources, verified, status, stale_after).

Ferramentas MCP

O servidor expõe quatro ferramentas principais:

• memory_store – Armazena ou atualiza um registro. Requer key, content e project_root. Opcionais: tags, namespace (padrão default), concept_type, title, description, resource, status, stale_after, sources, verified, generated_by.
• memory_retrieve – Obtém uma memória específica por key e namespace.
• memory_search – Encontra memórias por query, tags ou namespace. Suporta limit (padrão 10).
• memory_get_last – Recupera o último checkpoint de sessão (system/last_memory) para que o agente saiba onde o trabalho parou.

Isolamento por namespace e configuração

As memórias são delimitadas por namespace (por exemplo, user/preferences, project/architecture), mantendo os contextos separados. A configuração é um único comando:

python3 setup.py

Isso configura automaticamente as ferramentas MCP instaladas (Antigravity, Claude, Cursor, Windsurf, Codex). O servidor também suporta um parâmetro project_root para cada ferramenta, permitindo manter repositórios de memória por projeto.

Para quem é

Desenvolvedores que usam agentes de codificação de IA (Claude, Cursor, etc.) que desejam memória persistente e pesquisável, que permaneça em Markdown de texto simples e não exija banco de dados vetorial ou serviço externo.