/ Annuaire / Playground / Stash
● Communauté alash3al ⚡ Instantané

Stash

par alash3al · alash3al/stash

Un petit service mémoire Go pour les agents — épisodes (événements dans le temps) et faits (connaissances durables), exposés via MCP.

Stash offre aux agents deux modalités de stockage : les épisodes (événements ordonnés dans le temps) et les faits (connaissances durables en clé-valeur). Léger, binaire unique, facile à exécuter sur un Raspberry Pi.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

~/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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Stash

Conserver la mémoire de l'agent entre les sessions

👤 Développeurs ⏱ ~15 min intermediate

Quand l'utiliser : Vous souhaitez que Claude se souvienne des préférences et du contexte récent.

Déroulement
  1. Lancer stash
    docker run alash3al/stash✓ Copié
    → Service opérationnel
  2. Connecter MCP
    Ajoutez stash comme MCP dans la config Claude.✓ Copié
    → Outils visibles
  3. Utiliser
    remember "l'utilisateur préfère TypeScript à JS" ; rappel ultérieur.✓ Copié
    → Mémoire rappelée

Résultat : Continuité sans payer pour un SaaS mémoire complet.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

stash-mcp + filesystem

Exporter périodiquement la mémoire sur disque pour sauvegarde

Combiner stash-mcp avec filesystem : exporter périodiquement la mémoire sur disque pour sauvegarde✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
remember_episode (voir la documentation) Ajouter un événement à la timeline 1 appel
remember_fact (voir la documentation) Stocker un fait durable 1 appel
search (voir la documentation) Rechercher dans les deux magasins 1 appel

Coût et limites

Coût d'exécution

Quota d'API
Local
Tokens par appel
Petit
Monétaire
OSS gratuit
Astuce
Faites un snapshot du répertoire de données régulièrement

Sécurité

Permissions, secrets, portée

Stockage des identifiants : BD sur disque
Sortie de données : Aucune par défaut

Dépannage

Erreurs courantes et correctifs

Endpoint d'embedding manquant

Définissez EMBEDDING_URL ou exécutez en mode mots-clés uniquement

Alternatives

Stash vs autres

AlternativeQuand l'utiliserCompromis
memsearchVous souhaitez une échelle MilvusConfiguration plus lourde

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills