/ Directorio / Playground / Stash
● Comunidad alash3al ⚡ Instantáneo

Stash

por alash3al · alash3al/stash

Un pequeño servicio de memoria Go para agentes — episodios (eventos en el tiempo) y hechos (conocimiento durable), expuestos vía MCP.

Stash da a los agentes dos modalidades de almacenamiento: episodios (eventos ordenados por tiempo) y hechos (conocimiento durable clave-valor). Ligero, binario único, fácil de ejecutar en una Raspberry Pi.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "stash-mcp",
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "stash-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-p",
          "9000:9000",
          "ghcr.io/alash3al/stash:latest"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add stash-mcp -- docker run -p 9000:9000 ghcr.io/alash3al/stash:latest

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Stash

Mantener memoria del agente entre sesiones

👤 Desarrolladores ⏱ ~15 min intermediate

Cuándo usarlo: Quieres que Claude recuerde preferencias y contexto reciente.

Flujo
  1. Ejecutar stash
    docker run alash3al/stash✓ Copiado
    → Servicio activo
  2. Conectar MCP
    Add stash as MCP in Claude config.✓ Copiado
    → Herramientas visibles
  3. Usar
    remember "user prefers TypeScript over JS"; recall later.✓ Copiado
    → Memoria recordada

Resultado: Continuidad sin pagar por un SaaS de memoria completo.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

stash-mcp + filesystem

Volcar periódicamente la memoria a disco para backup

Combine stash-mcp with filesystem: Periodically dump memory to disk for backup✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
remember_episode (see docs) Agregar un evento a la línea de tiempo 1 call
remember_fact (see docs) Almacenar un hecho durable 1 call
search (see docs) Buscar en ambos almacenes 1 call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Local
Tokens por llamada
Pequeño
Monetario
OSS gratuito
Consejo
Toma snapshots del directorio de datos regularmente

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Base de datos en disco
Salida de datos: Ninguno por defecto

Resolución de problemas

Errores comunes y soluciones

Endpoint de embedding faltante

Establece EMBEDDING_URL o ejecuta en modo solo-palabras-clave

Alternativas

Stash vs otros

AlternativaCuándo usarlaContrapartida
memsearchQuieres escala respaldada por MilvusConfiguración más pesada

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills