Memory Bank MCP MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Cinq outils : memory_bank_read, memory_bank_write, memory_bank_update, list_projects, list_project_files
Isolation multi-projets : chaque projet possède son propre dossier sous MEMORY_BANK_ROOT
Prévention intégrée du parcours – limitée à la racine que vous configurez
Opérations de type sécurisé avec messages d'erreur explicites
Fonctionne avec n'importe quel client MCP ; pas de dépendance Cline

Démo en direct

Aperçu en pratique

memory-bank-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memory-bank-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "memory-bank-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@allpepper/memory-bank-mcp"
        ]
      }
    }
  }
}

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

claude mcp add memory-bank-mcp -- npx -y @allpepper/memory-bank-mcp

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

Cas d'usage

Usages concrets : Memory Bank MCP

Donnez à un nouvel agent un contexte instantané sur un projet de longue durée

👤 Équipes exécutant plusieurs agents sur la même base de code ⏱ ~10 min beginner

Quand l'utiliser : Une nouvelle discussion nécessite le même contexte (conventions, décisions passées, bugs connus) que votre dernière discussion déjà apprise.

Prérequis

Banque de mémoire existante pour ce projet — Remplissez-le pendant le travail normal avec memory_bank_write

Déroulement

Lister les fichiers dont dispose déjà la banque de projet

Appelez list_project_files pour project=acme-api.✓ Copié

→ architecture.md, décisions.md, questions ouvertes.md, etc.
Charger le sous-ensemble concerné

Lisez Decisions.md et open-questions.md avant de commencer la tâche.✓ Copié

→ L'agent fait référence aux décisions antérieures au lieu de demander à nouveau

Résultat : Les nouvelles séances commencent à chaud au lieu de froid ; vous arrêtez de payer la taxe d'embarquement à chaque fois.

Pièges

Laisser la banque se transformer en un seul fichier géant — Réparti par préoccupation (décisions, architecture, questions ouvertes, runbook) afin que l'agent ne charge que ce dont il a besoin

Combiner avec : codebase-memory

Versionnez la mémoire de votre agent dans git comme n'importe quel autre document de projet

👤 Les équipes qui veulent que la mémoire survive entre les machines et les contributeurs ⏱ ~20 min intermediate

Quand l'utiliser : Vous souhaitez que les fichiers de mémoire soient examinés, consultables et partagés avec vos coéquipiers.

Prérequis

Dépôt Git pour héberger la banque — git init dans MEMORY_BANK_ROOT ou dans un sous-dossier du projet

Déroulement

Faire de la racine un dépôt

Transformez ~/ai-memory en un dépôt git ; ajoutez un .gitignore pour tout ce qui est sensible.✓ Copié

→ Structure de dépôt Git standard
Laisser l'agent mettre à jour la mémoire pendant les sessions

Après avoir corrigé le bogue, appelez memory_bank_update pour enregistrer la cause première dans bugs.md.✓ Copié

→ Nouvelle différence prête à être validée
S'engager et pousser

Vérifiez la différence de mémoire, validez, poussez.✓ Copié

→ Les coéquipiers tirent et leurs agents partagent immédiatement le contexte

Résultat : La mémoire des agents devient un artefact de projet de premier ordre.

Pièges

Commettre des secrets que l'agent a notés — Ajoutez un scanner de pré-validation (par exemple, gitleaks) avant de pousser le dépôt de mémoire

Combiner avec : github · git

Combinaisons

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

memory-bank-mcp + filesystem

La banque de mémoire conserve les notes des agents ; le système de fichiers lit le code auquel ils se réfèrent

Lisez Decisions.md depuis la banque de mémoire, puis ouvrez les fichiers auxquels il fait référence dans src/.✓ Copié

memory-bank-mcp + github

Après la fusion d'un PR, enregistrez le résultat dans la banque de mémoire du projet

Résumez le PR #412 fusionné et mettez à jour memory-bank/acme-api/decisions.md.✓ Copié

memory-bank-mcp + codebase-memory

Deux couches de mémoire complémentaires : mémoire graphique de code + notes lisibles par l'homme

Combinez le graphique des symboles de mémoire de base de code avec le récit dans memory-bank/architecture.md.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
memory_bank_read	project: str, file: str	Extrayez la mémoire existante avant de planifier
memory_bank_write	project: str, file: str, content: str	Créez un tout nouveau fichier mémoire
memory_bank_update	project: str, file: str, content: str	Modifier un fichier mémoire existant (échec s'il est manquant)
list_projects	(none)	Découvrez quels projets disposent déjà de banques de mémoire
list_project_files	project: str	Voir quels fichiers de mémoire sont disponibles avant de lire

Coût et limites

Coût d'exécution

Quota d'API: Pas d'API externe
Tokens par appel: Cela dépend de la taille du fichier ; note typique 200-2000 jetons
Monétaire: Gratuit – fonctionne localement
Astuce: Gardez les fichiers de mémoire courts et thématiques ; le chargement d'un fichier de 50 Ko gaspille le contexte à chaque appel.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucune information d'identification. Le chemin MEMORY_BANK_ROOT est la seule configuration.

Sortie de données : Aucun appel réseau - les lectures et écritures restent sur le système de fichiers local sous MEMORY_BANK_ROOT.

Ne définissez pas MEMORY_BANK_ROOT sur la racine de votre domicile ou de votre projet : étendez-le à un dossier dédié afin que les agents ne puissent pas lire des fichiers sans rapport.
Vérifiez ce que les agents écrivent en mémoire avant de le valider dans git ; les transcriptions des discussions peuvent inclure des secrets que l'agent a vus plus tôt.

Dépannage

Erreurs courantes et correctifs

Erreur : MEMORY_BANK_ROOT n'est pas défini

Définissez la variable d'environnement dans la configuration de votre client MCP et redémarrez le client.

Vérifier : echo $MEMORY_BANK_ROOT

ENOENT lors de la lecture d'un fichier

Appelez d'abord list_project_files — le nom de fichier doit exister exactement.

Vérifier : ls $MEMORY_BANK_ROOT/<project>/

EACCES en écriture

Assurez-vous que le processus MCP dispose d'une autorisation d'écriture sur MEMORY_BANK_ROOT.

Vérifier : touch $MEMORY_BANK_ROOT/.probe && rm $MEMORY_BANK_ROOT/.probe

Alternatives

Memory Bank MCP vs autres

Alternative	Quand l'utiliser	Compromis
memory (official)	Vous voulez un graphique de connaissances, pas des notes basées sur des fichiers	Le graphique est structuré mais moins modifiable par l'homme
memory-service	Vous voulez une recherche sémantique sur la mémoire	Configuration plus lourde ; intégrations requises
Cline Memory Bank (inline)	Vous utilisez uniquement Cline et n'avez pas besoin de partage entre IDE	Verrouillé à Cline

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills