sovseal Memory

sovseal MCP Server

Um servidor MCP que dá ao Claude, Cursor e a todos os clientes MCP uma memória compartilhada que nunca sai da sua máquina. Busca vetorial no dispositivo via LanceDB + Transformers.js (embeddings de 384 dimensões), criptografia AES-256-GCM no lado do cliente e sincronização de texto cifrado em write-behind. Leituras com 0 RTT.

Ferramentas

Store Memory (store_memory)

Insere e persiste um fato de contexto no nó de memória local no dispositivo.

Parâmetros:

• content (string, obrigatório): Uma declaração factual em terceira pessoa para armazenar (máx. 65.536 caracteres)

Comportamento:

• Insere conteúdo no dispositivo (intfloat/multilingual-e5-small, 384-dim, ONNX)
• Grava no LanceDB local — retorna imediatamente
• A sincronização de texto cifrado roda em write-behind; nada bloqueia o chamador
• Remove duplicatas e reforça automaticamente entradas existentes
• PII de alto risco (SSNs, cartões de crédito, chaves de API) é automaticamente mascarada antes do armazenamento

Recall Memory (recall_memory)

Busca semântica sobre o contexto de memória armazenado. Retorna as top-K memórias relevantes por distância L2.

Parâmetros:

• query (string, obrigatório): String de consulta semântica para buscar memórias passadas
• topK (number, opcional): Número máximo de memórias a retornar (1–20, padrão: 5)

Comportamento:

• Insere a consulta no dispositivo (pipeline com cache LRU) → busca vetorial no LanceDB local
• 0 RTT — a rede nunca está no caminho de leitura
• Retorna [score=NUMBER id=ID] text para cada correspondência — pontuação menor = correspondência semântica mais próxima
• Retorna no_matches quando o armazenamento não tem entradas relevantes

Recursos

Briefing Context (sovseal://context/briefing)

Um briefing resumido e ciente de reforço de memórias processuais, semânticas e recorrentes. Recomendado para iniciar novas conversas com o contexto de usuário armazenado.

Recent Context (sovseal://context/recent) — Obsoleto

Lista bruta dos fatos de contexto armazenados mais recentemente. Use sovseal://context/briefing em vez disso.

Prompts

Context Injection (/sovseal:context)

Auxiliar de prompt de sistema que inicia uma conversa lendo de sovseal://context/recent antes do primeiro turno.

Configuração

Nenhuma Chave de API Necessária

O sovseal roda 100% no dispositivo. Não há chave de API externa, nenhuma dependência de nuvem e nenhuma conta necessária para operações de memória local.

Variáveis de Ambiente

O servidor suporta as seguintes variáveis de ambiente:

• SOVSEAL_TRANSPORT: Modo de transporte ("stdio" ou "sse", padrão: "stdio")
• SOVSEAL_PORT: Porta do servidor SSE (padrão: 4040)

Instalação

Uso com Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "sovseal-memory": {
      "command": "npx",
      "args": ["-y", "@sovseal/mcp-server"]
    }
  }
}

Uso com Cursor

Adicione às configurações MCP do seu Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "sovseal-memory": {
      "command": "npx",
      "args": ["-y", "@sovseal/mcp-server"]
    }
  }
}

Uso com VS Code (Copilot / Cline / Roo)

Adicione às suas Configurações de Usuário (JSON) ou .vscode/mcp.json:

{
  "servers": {
    "sovseal-memory": {
      "command": "npx",
      "args": ["-y", "@sovseal/mcp-server"]
    }
  }
}

Uso com Windsurf / Zed / OpenCode

{
  "mcpServers": {
    "sovseal-memory": {
      "command": "npx",
      "args": ["-y", "@sovseal/mcp-server"]
    }
  }
}

Onboarding Automático (Todos os Clientes)

Detecte sua IDE, configure as configurações globais de conexão e escreva instruções de sistema automaticamente:

npx -y @sovseal/mcp-server onboard --write --register

Suportados: Cursor, Claude Desktop/Code, Windsurf, VS Code (Copilot/Cline/Roo), Zed, Google Antigravity e OpenCode.

Transporte HTTP/SSE

Para agentes autônomos sempre ativos, execute como um servidor HTTP/SSE de longa duração:

SOVSEAL_TRANSPORT=sse SOVSEAL_PORT=4040 npx -y @sovseal/mcp-server

Endpoint Hospedado

Um endpoint HTTP/SSE hospedado está disponível para clientes MCP baseados na web e validação de marketplace:

https://sovseal-mcp-server.barrackbobby1.workers.dev/mcp

Como Ele Permanece Privado

• Criptografia AES-256-GCM no lado do cliente com IV aleatório de 96 bits por snapshot
• A chave de 256 bits vive em ~/.sovseal/config.json (modo 0600) — perca este arquivo, perca todos os snapshots
• O servidor só vê texto cifrado + caminhos derivados de SHA-256; ele não pode ler seu contexto
• Verified Semantic Recall (VSR) — cada carregamento re-deriva sha256(canonicalize(payload)) e falha de forma segura em caso de incompatibilidade
• Garantia de Captura de Pacotes — execute Wireshark ou tcpdump contra o servidor; se você encontrar um único byte de contexto não criptografado na rede, o software é gratuito para sempre

Desempenho

Carga de trabalho	Operação	p50	p95	p99
10K registros · 1K consultas	recall_memory (quente)	6,1 ms	10,4 ms	21,8 ms
Gravação única	store_memory	3,8 ms	7,2 ms	12,5 ms
Primeira chamada	recall_memory (frio)	~1,2 s	—	—

Todas as operações são 0 RTT — a rede nunca está no caminho de leitura.

Build

npm install
npm run build

Desenvolvimento

Pré-requisitos

• Node.js 20.x ou superior
• npm ou pnpm

Configuração

1. Clone o repositório:

git clone https://github.com/sovseal/mcp-server.git
cd mcp-server

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

Testes via MCP Inspector

1. Compile e inicie o servidor:

npm run build
node dist/index.js

2. Em outro terminal, inicie o MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Scripts Disponíveis

• npm run build: Compila o projeto TypeScript
• npm run dev: Observa mudanças e recompila
• npm run typecheck: Verificação de tipos sem emitir
• npm run test: Executa a suíte de testes (Vitest)
• npm run test:watch: Testes em modo de observação
• npm run bench: Executa benchmarks de desempenho

Links

• Site: sovseal.com
• Documentação: docs.sovseal.com
• Central de Confiança: trust.sovseal.com
• Extensão do Chrome: Chrome Web Store
• Monorepo Completo: github.com/sovseal/core

Licença

Apache 2.0