@memofs/mcp-server

O @memofs/mcp-server permite que agentes de codificação de IA leiam e escrevam com segurança na memória MemoFS por meio de ferramentas padrão do Model Context Protocol.

Ver em memofs.devExperimente este MCPPatrocinado

Documentação

~ ls .memofs/

Armazene decisões, fatos e contexto como arquivos markdown simples no seu projeto — versionados, portáteis e sempre disponíveis quando a próxima sessão começar.

cursor: cur_0x4f02a9

digest: sha256

[mount: file-first]

O Problema

A memória de Agentes de IA está quebrada em duas direções.

De um lado, manuais markdown estáticos como AGENTS.md, CLAUDE.md e .cursor/rules incham as janelas de contexto com enormes despejos de tokens que silenciosamente se desatualizam no momento em que arquivos do projeto, documentações, esquemas de dados ou implementações mudam.

Do outro lado, bancos de dados vetoriais hospedados travam fatos aprendidos dentro de caixas pretas proprietárias, invisíveis, impossíveis de revisar em um git diff, desconectados do seu projeto e presos na nuvem de outra pessoa.

Desatualização Silenciosa do Projeto.

Quando arquivos do projeto, esquemas, documentações ou código mudam, memórias não ancoradas referenciam ativos deletados e fatos obsoletos, transformando-se em contexto fantasma tóxico que ativamente leva a IA a alucinações.

O Silo de Caixa Preta.

Bancos de dados vetoriais proprietários travam conhecimento aprendido atrás de APIs opacas. Você não pode inspecionar o que a IA aprendeu, editar no seu editor local ou revisar em um git diff junto com seu projeto.

O Dilema do Inchaço de Prompt.

Manuais estáticos (como arquivos de instrução de 50KB) queimam milhares de tokens de prompt a cada turno, enquanto modelos de IA esquecem de consultar memória dinâmica a menos que o runtime a empurre deterministicamente.

Runtimes

Um motor, três modos de armazenamento

MemoFS é construído sobre uma abstração de armazenamento unificada. Escolha onde sua memória reside com base no seu fluxo de trabalho e necessidades de acesso.

RUNTIME 01Offline Primeiro

Diagrama do Modo Local

Modo de Armazenamento Local

Toda a memória é armazenada diretamente no sistema de arquivos do seu projeto como markdown e JSON versionados. Zero latência de rede, totalmente offline e 100% rastreável via git.

RUNTIME 02Sincronização na Nuvem

Diagrama do Modo Híbrido

Modo de Sincronização Híbrido

Execução local em sub-milissegundos com replicação automática na nuvem. A memória do seu agente segue você entre múltiplas máquinas, estações de trabalho desktop e colegas de equipe.

RUNTIME 03Zero Arquivos Locais

Diagrama do MCP Hospedado

Endpoint MCP Hospedado

O MemoFS Cloud hospeda o runtime diretamente. Agentes remotos, contêineres CI/CD efêmeros e bots serverless conectam-se via URL de endpoint MCP padrão e chave de API.

Recursos e Capacidades

Projetado para memória autônoma de agentes

De recall híbrido local em sub-milissegundos a âncoras de projeto auto-reparáveis e coordenação multi-agente. Construído com arquivos transparentes, lógica determinística e zero caixas pretas.

RECURSO 01Defesa contra Desatualização

Ancoragem de Código & Detecção de Desatualização

Ancoragem de Projeto & Detecção de Desatualização

Memórias ligam-se diretamente a arquivos do projeto, documentos de pesquisa, esquemas de dados, hashes de bytes e caminhos de símbolos. Quando ativos subjacentes mudam, a detecção de desatualização em tempo de consulta rebaixa automaticamente a relevância de memórias obsoletas antes que causem alucinações.

RECURSO 02Fusão com Portão

Recall Híbrido & Fusão

Recall Híbrido & Fusão com Portão

Correspondência lexical de palavras-chave BM25 em sub-milissegundos fundida com embeddings vetoriais densos via ranqueamento de bônus limitado com portão. Unifica a identidade de pedaços de memória para eliminar duplicatas e evitar inchaço de contexto do LLM.

RECURSO 03Grafo Nativo

Grafo de Entidades & Consolidação

Grafo de Entidades & Proveniência Causal

Extrai entidades, relacionamentos e linhagem causal (memofs why) em arquivos transparentes nodes.jsonl e edges.jsonl. Consolidação determinística e controlada por crítico mescla fatos redundantes e rastreia decisões até a evidência de origem.

RECURSO 04Contexto Isolado

Scratchpads de Workspace AgentFS

Sistema de arquivos scratch isolado por turno de agente com promoção de memória controlada por resultado (sucesso, falha, abortado). Preserva e promove automaticamente fatos duráveis de alto sinal enquanto poda ruído de sessão intermediário.

RECURSO 05Zero Omissão

Imposição de Comportamento do Agente

Imposição de Comportamento em Runtime

Hooks de push determinísticos em mais de 9 ferramentas de IA e ambientes de agente, incluindo Claude Code, Cursor, Copilot, Codex e Gemini CLI. Injeta automaticamente contexto de memória relevante no início da sessão, impõe restrições do projeto e preserva estado entre compactações de contexto.

RECURSO 06Pisos de Decaimento

Decaimento Cognitivo & Arquivo Frio

Janelas de expiração por tipo de memória envelhecem fatos para status não verificado sem manutenção manual. Consolidação guiada por operador move memórias superadas para arquivo frio com restauração forense completa.

RECURSO 07Em Breve

Stream Efêmero & Pub/Sub de Agente

Stream append-only em tempo real para coordenação transitória entre agentes (heartbeats, intenção de arquivo, status de tarefa) e dicas de direção humana. Filtrado do recall durável para eliminar ruído, com coleta de lixo automatizada por TTL em execuções de manutenção.

RECURSO 08Em Breve

Memória Procedural & Playbooks

Receitas de fluxo de trabalho passo a passo acionáveis e procedimentos operacionais padrão armazenados como Markdown legível por humanos e JSON estruturado. Estrategista de contexto combina e apresenta dinamicamente playbooks relevantes com base no tipo de tarefa.

RECURSO 09Em Breve

Linter Estático de Memória

Analisador estático semântico CLI (memofs lint) para pipelines de CI/CD. Detecta afirmações contraditórias em notas armazenadas, links de proveniência causal quebrados, referências mortas de projeto e entidades órfãs de grafo de conhecimento antes do merge.

RECURSO 10Em Breve

Estúdio Visual de Memória

Depurador webview local sem dependências para .memofs/. Inspecione detalhamentos de peso de recall BM25 vs vetor vs grafo, explore grafos de entidades interativos e teste diffs de rollback de snapshot em tempo real.

RECURSO 11Em Breve

Importação de Memória de Fornecedores

Importação & Configuração de Memória de Fornecedores

Um comando para trazer sua memória existente com você — importe de ferramentas de desenvolvedor, agentes de pesquisa, além de exportações de Mem0, Zep/Graphiti, Letta e Cognee. Adaptadores de arquivo offline completos gravam através do caminho durável padrão com proveniência e pré-visualização dry-run.

RECURSO 12Em Breve

Recibos de Ações Imutáveis

Recibos de auditoria somente de acréscimo que capturam ações de IA consequentes, correlação de tarefas, parentesco causal, metadados de reversibilidade, resumos de argumentos e hashes de snapshots antes/depois para responsabilidade completa de execução.

Por que Arquivo-Primeiro

MemoFS vs. Memória de Caixa-Preta

A maioria das ferramentas de memória esconde seus dados em bancos de dados remotos opacos ou depende de arquivos de regras estáticos que se desatualizam e inflam o contexto do prompt. O MemoFS combina execução local determinística, verificação ancorada no projeto e transparência nativa do git.

Dimensão	MemoFS	Bancos de Dados de Memória Hospedados
Onde a memória vive	✓Arquivos Markdown e JSONL simples em .memofs/	✕Travado em um banco de dados proprietário na nuvem
Detecção de desatualização do projeto	✓Hash de arquivo, símbolo AST e validação de esquema (memofs lint)	✕Nenhum; memórias obsoletas referenciam ativos e dados excluídos
Aplicação de comportamento	✓Hooks de push determinísticos em mais de 9 ferramentas e runtimes de IA	✕Ferramentas de pull passivas; depende do modelo lembrar de pesquisar
Linhagem causal e auditoria	✓Recibos de ações imutáveis e travessia causal (memofs why)	✕Pontuações de similaridade opacas; logs de chat efêmeros perdidos
Inspecionar e editar	✓Qualquer editor (VS Code, Cursor, Neovim, CLI)	✕Painel web do fornecedor ou arquivo bruto não indexado
Controle de versão	✓Rastreado pelo git e ramificável junto com seu projeto	✕Banco de dados externo separado, desacoplado do histórico do projeto
Eficiência de contexto	✓Recuperação híbrida com orçamento de tokens (BM25 + vetor + grafo)	✕Inflação monolítica de prompt ou embeddings top-k ruidosos
Execução offline	✓100% local-primeiro; funciona offline e em sandboxes	✕Requer rede persistente e chaves de API na nuvem
Coordenação multi-agente	✓Bloqueios de arquivo consultivos e esquemas de fluxo padrão	✕Gravações não sincronizadas ou daemons externos pesados