sovseal Memory

sovseal MCP Server

Un servidor MCP que brinda a Claude, Cursor y a cada cliente MCP una memoria compartida que nunca sale de tu máquina. Búsqueda vectorial en el dispositivo mediante LanceDB + Transformers.js (embeddings de 384 dimensiones), cifrado AES-256-GCM en el lado del cliente y sincronización de texto cifrado con escritura diferida. Lecturas de 0 RTT.

Herramientas

Store Memory (store_memory)

Incorpora y persiste un hecho de contexto dentro del nodo de memoria local en el dispositivo.

Parámetros:

• content (cadena, obligatorio): Una declaración factual en tercera persona para almacenar (máx. 65 536 caracteres)

Comportamiento:

• Incorpora contenido en el dispositivo (intfloat/multilingual-e5-small, 384 dimensiones, ONNX)
• Escribe en LanceDB local — devuelve inmediatamente
• La sincronización de texto cifrado se ejecuta con escritura diferida; nada bloquea al llamante
• Elimina automáticamente duplicados y refuerza las entradas existentes
• La información personal de alto riesgo (números de seguro social, tarjetas de crédito, claves API) se redacta automáticamente antes del almacenamiento

Recall Memory (recall_memory)

Búsqueda semántica sobre el contexto de memoria almacenado. Devuelve las K memorias más relevantes por distancia L2.

Parámetros:

• query (cadena, obligatorio): Cadena de consulta semántica para buscar memorias pasadas
• topK (número, opcional): Número máximo de memorias a devolver (1–20, predeterminado: 5)

Comportamiento:

• Incorpora la consulta en el dispositivo (canalización con caché LRU) → búsqueda vectorial en LanceDB local
• 0 RTT — la red nunca está en la ruta de lectura
• Devuelve [score=NUMBER id=ID] text para cada coincidencia — puntuación menor = coincidencia semántica más cercana
• Devuelve no_matches cuando el almacén no tiene entradas relevantes

Recursos

Briefing Context (sovseal://context/briefing)

Un resumen informativo, consciente del refuerzo, de memorias procedimentales, semánticas y recurrentes. Recomendado para iniciar nuevas conversaciones con el contexto de usuario almacenado.

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

Lista sin procesar de los hechos de contexto almacenados más recientemente. Usa sovseal://context/briefing en su lugar.

Prompts

Context Injection (/sovseal:context)

Asistente de prompt de sistema que inicia una conversación leyendo desde sovseal://context/recent antes del primer turno.

Configuración

No se requiere clave API

sovseal se ejecuta 100% en el dispositivo. No hay clave API externa, ni dependencia de la nube, ni se requiere cuenta para las operaciones de memoria local.

Variables de entorno

El servidor admite las siguientes variables de entorno:

• SOVSEAL_TRANSPORT: Modo de transporte ("stdio" o "sse", predeterminado: "stdio")
• SOVSEAL_PORT: Puerto del servidor SSE (predeterminado: 4040)

Instalación

Uso con Claude Desktop

Añade esto a tu claude_desktop_config.json:

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

Uso con Cursor

Añade a la configuración MCP de tu Cursor (~/.cursor/mcp.json):

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

Uso con VS Code (Copilot / Cline / Roo)

Añade a tu configuración de usuario (JSON) o .vscode/mcp.json:

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

Uso con Windsurf / Zed / OpenCode

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

Incorporación automática (todos los clientes)

Detecta tu IDE, configura los ajustes de conexión globales y escribe instrucciones de sistema automáticamente:

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

Compatible con: Cursor, Claude Desktop/Code, Windsurf, VS Code (Copilot/Cline/Roo), Zed, Google Antigravity y OpenCode.

Transporte HTTP/SSE

Para agentes autónomos siempre activos, ejecuta como servidor HTTP/SSE de larga duración:

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

Endpoint alojado

Un endpoint HTTP/SSE alojado está disponible para clientes MCP basados en web y validación de marketplace:

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

Cómo se mantiene privado

• Cifrado AES-256-GCM en el lado del cliente con un IV aleatorio de 96 bits por instantánea
• La clave de 256 bits reside en ~/.sovseal/config.json (modo 0600) — pierde este archivo, pierde cada instantánea
• El servidor solo ve texto cifrado + rutas derivadas de SHA-256; no puede leer tu contexto
• Recuperación Semántica Verificada (VSR) — cada carga vuelve a derivar sha256(canonicalize(payload)) y falla de forma segura ante una discrepancia
• Garantía de captura de paquetes — ejecuta Wireshark o tcpdump contra el servidor; si encuentras un solo byte de contexto sin cifrar en la red, el software es gratuito para siempre

Rendimiento

Carga de trabajo	Operación	p50	p95	p99
10K registros · 1K consultas	recall_memory (en caliente)	6.1 ms	10.4 ms	21.8 ms
Escritura única	store_memory	3.8 ms	7.2 ms	12.5 ms
Primera llamada	recall_memory (en frío)	~1.2 s	—	—

Todas las operaciones son 0 RTT — la red nunca está en la ruta de lectura.

Compilación

npm install
npm run build

Desarrollo

Requisitos previos

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

Configuración

1. Clona el repositorio:

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

2. Instala las dependencias:

npm install

3. Compila el proyecto:

npm run build

Pruebas mediante MCP Inspector

1. Compila e inicia el servidor:

npm run build
node dist/index.js

2. En otra terminal, inicia el MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Scripts disponibles

• npm run build: Compila el proyecto TypeScript
• npm run dev: Observa los cambios y recompila
• npm run typecheck: Verificación de tipos sin emitir
• npm run test: Ejecuta la suite de pruebas (Vitest)
• npm run test:watch: Pruebas en modo observación
• npm run bench: Ejecuta benchmarks de rendimiento

Enlaces

• Sitio web: sovseal.com
• Documentación: docs.sovseal.com
• Centro de confianza: trust.sovseal.com
• Extensión de Chrome: Chrome Web Store
• Monorepo completo: github.com/sovseal/core

Licencia

Apache 2.0