whimsicality-mcp

Un servidor MCP (Model Context Protocol) que proporciona a los agentes de IA memoria persistente — almacenamiento de contexto, hechos, planes, búsqueda RAG, fragmentos de código y compactación de conversaciones que sobreviven entre sesiones y procesos.

Funciona con cualquier agente compatible con MCP: Devin CLI, Claude Desktop, Cursor y otros.

Inicio rápido

# Install globally
npm install -g whimsicality-mcp

# Or run without installing
npx whimsicality-mcp

Luego añádelo a la configuración MCP de tu agente:

{
  "mcpServers": {
    "whimsicality": {
      "command": "npx",
      "args": ["whimsicality-mcp"]
    }
  }
}

Eso es todo. El servidor funciona de inmediato con persistencia basada en disco — no se requieren dependencias nativas. Los datos se almacenan en ~/.whimsicality/kernel-storage/.

Related MCP server: Memory MCP

Herramientas

El servidor expone 14 herramientas, todas con el prefijo whim_:

Cómo deberían usarlo los agentes

Al inicio de la sesión — recupera el estado de agentes anteriores:

1. whim_plan_get({})              → read the current plan
2. whim_facts_list({})            → list all facts
3. whim_facts_get({name: "..."})  → read relevant facts
4. whim_context_list({})          → list all context slots
5. whim_context_get({key: "..."}) → read relevant slots

Mientras trabajas — guarda el estado para el siguiente agente:

whim_plan_save({plan: "updated plan with progress and next steps"})
whim_facts_save({name: "new_fact", value: "..."})
whim_context_set({key: "what_i_learned", text: "..."})

Backends

El servidor admite cuatro formas de encontrar el kernel, probadas en orden:

1. Respaldo en disco (predeterminado, sin configuración)

Funciona de inmediato. Los datos se persisten en un archivo JSON en ~/.whimsicality/kernel-storage/whim-mcp-store.json. Búsqueda por solapamiento de palabras para RAG/fragmentos. Sin dependencias nativas.

2. Binario de kernel precompilado (la actualización más fácil)

npm install @whimsicalitylabs/kernel-prebuilt

Binarios precompilados específicos de plataforma distribuidos a través de npm optionalDependencies. El servidor descubre automáticamente el binario en node_modules.

Nota: Los binarios precompilados aún no están disponibles para todas las plataformas. Consulta kernel-prebuilt para conocer el estado.

3. Apuntar a un binario existente

{
  "mcpServers": {
    "whimsicality": {
      "command": "npx",
      "args": ["whimsicality-mcp"],
      "env": {
        "WHIMSICALITY_KERNEL_BIN": "/path/to/whimsicality-kernel"
      }
    }
  }
}

4. Compilar desde el código fuente

Clona el espacio de trabajo Rust y compila:

git clone https://github.com/WhimsicalityLabs/whimsicality-kernel.git
cd whimsicality-kernel
cargo build --release

Luego establece WHIMSICALITY_KERNEL_BIN a target/release/whimsicality-kernel.

Lo que añade el kernel

El kernel Rust proporciona:

• Almacenamiento por niveles: caliente (RAM) → templado (mmap) → frío (zstd en disco) con promoción/democión automática

• Deduplicación por contenido: los valores idénticos comparten almacenamiento mediante hash blake3

• Ruta caliente sin bloqueos: DashMap para lecturas concurrentes

• Registro de sesión de solo añadido: entradas bincode con ramificación/bifurcación

• Ensamblaje de contexto estructurado: variables con nombre, no flujos de tokens planos

Cuando el kernel está disponible, el servidor escribe en doble tanto en el kernel como en el disco. Esto te da el acceso rápido del kernel dentro de la sesión más la persistencia en disco para la fiabilidad entre sesiones (el nivel caliente del kernel es solo RAM y se pierde al salir del proceso).

Configuración

Toda la configuración se realiza mediante variables de entorno:

Desarrollo

git clone https://github.com/WhimsicalityLabs/Whimsicality-MCP.git
cd whimsicality-mcp
npm install
npm run build
node bin/whimsicality-mcp.js

Licencia

MIT