sovseal Memory

Servidor MCP sovseal

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

Herramientas

Almacenar Memoria (store_memory)

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

Parámetros:

• content (cadena, obligatorio): 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 en segundo plano; nada bloquea al llamante
• Deduplica y refuerza automáticamente las entradas existentes
• La información de identificación personal (PII) de alto riesgo (números de seguridad social, tarjetas de crédito, claves API) se redacta automáticamente antes del almacenamiento

Recuperar Memoria (recall_memory)

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

Parámetros:

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

Comportamiento:

• Incorpora la consulta en el dispositivo (pipeline 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 por cada coincidencia — una puntuación menor significa una coincidencia semántica más cercana
• Devuelve no_matches cuando el almacén no tiene entradas relevantes

Recursos

Contexto de Briefing (sovseal://context/briefing)

Un briefing resumido y sensible al refuerzo de memorias procedimentales, semánticas y recurrentes. Recomendado para iniciar nuevas conversaciones con contexto de usuario almacenado.

Contexto Reciente (sovseal://context/recent) — Obsoleto

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

Prompts

Inyección de Contexto (/sovseal:context)

Ayudante de prompt de sistema que inicia una conversación leyendo de 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 cuenta requerida para operaciones de memoria local.

Variables de Entorno

El servidor soporta las siguientes variables de entorno:

• SOVSEAL_TRANSPORT: Modo de transporte ("stdio" o "sse", por defecto: "stdio")
• SOVSEAL_PORT: Puerto del servidor SSE (por defecto: 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 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 las opciones de conexión globales y escribe las instrucciones del sistema automáticamente:

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

Soportados: 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 un servidor HTTP/SSE de larga duración:

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

Endpoint Alojado

Hay un endpoint HTTP/SSE alojado disponible para clientes MCP basados en la web y validación de marketplace:

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

Cómo Se Mantiene Privado

• Cifrado AES-256-GCM del lado del cliente con IV aleatorio de 96 bits por instantánea
• La clave de 256 bits vive 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
• Verificación Semántica de Recuerdo (VSR) — cada carga re-deriva sha256(canonicalize(payload)) y falla cerrado 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 (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 (frío)	~1.2 s	—	—

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

Construcción

npm install
npm run build

Desarrollo

Prerrequisitos

• 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. Construye el proyecto:

npm run build

Pruebas mediante MCP Inspector

1. Construye 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: Construye el proyecto TypeScript
• npm run dev: Observa cambios y reconstruye
• 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 observador
• npm run bench: Ejecuta puntos de referencia 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