Memorix (MCP server) — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Cross-agent : fonctionne avec Claude Code, Cursor, Codex, Windsurf, Gemini CLI, OpenCode, Antigravity, Trae
Ajout uniquement avec historique des révisions
Rappel par tags (projet, langage, décision)
Backend SQLite local ; sync cloud optionnelle
Minuscule — binaire Node unique
MIT

Démo en direct

Aperçu en pratique

memorix-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": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

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

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

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

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": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

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

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memorix-mcp",
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "memorix-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "memorix"
        ]
      }
    }
  }
}

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

claude mcp add memorix-mcp -- npx -y memorix

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

Cas d'usage

Usages concrets : Memorix

Partager les conventions de projet entre tous les agents de code sans réécriture

👤 Devs jonglant avec plusieurs outils AI de code ⏱ ~15 min beginner

Quand l'utiliser : Vous expliquez la même structure de monorepo à Cursor, Claude Code et Codex le jour 1 et oubliez lequel sait quoi.

Prérequis

Memorix en cours d'exécution — npx memorix — utilise ~/.memorix.db par défaut

Déroulement

Alimenter les mémoires

Save these facts about my project: package manager pnpm, runtime node 22, db postgres 16, auth in /apps/api/src/auth (not /legacy/auth).✓ Copié

→ 5 mémoires ajoutées avec tags
Rappeler dans un autre agent

(dans Cursor avec le même Memorix) — What conventions are set for this project?✓ Copié

→ Retourne les mêmes 5 mémoires
Mettre à jour l'une d'elles

Update memory: now using node 24 (was 22). Keep history.✓ Copié

→ Mis à jour ; historique préservé en tant que révision

Résultat : Le contexte du projet persiste entre les agents et les jours.

Pièges

Les mémoires deviennent obsolètes — Utilisez decay pour marquer les anciennes mémoires avec une faible confiance ; les agents pondèrent en conséquence

Capturer des décisions architecturales comme mémoires interrogeables

👤 Tech leads, ingénieurs staff ⏱ ~20 min intermediate

Quand l'utiliser : Vous prenez une décision (« nous n'utilisons pas Redux, juste zustand ») et voulez qu'elle soit respectée.

Déroulement

Journaliser la décision

Save decision: 'Use zustand, not Redux. Reason: simpler API, smaller bundle.' Tag: state-management.✓ Copié

→ Décision sauvegardée avec tag
Vérifier l'application

Whenever Claude is about to import redux in this repo, reject and quote the decision.✓ Copié

→ Les imports suivants sont signalés avec la raison sauvegardée

Résultat : Un journal ADR-light que les agents lisent vraiment.

Pièges

Memorix est par utilisateur ; les ADR à l'échelle de l'équipe nécessitent sync cloud ou miroir commité — Utilisez --export ./adr.json et commitez ; les coéquipiers --import pour synchroniser

Combiner avec : github

Transférer une session de débogage à un autre agent

👤 Devs qui alternent entre modèles en cours de tâche ⏱ ~10 min intermediate

Quand l'utiliser : Claude débogue depuis 2h et vous voulez passer à Codex sans tout ré-expliquer.

Déroulement

Snapshot

Snapshot current debugging context: hypothesis, what we ruled out, next step.✓ Copié

→ Snapshot sauvegardé avec tag debug-session-<id>
Reprendre ailleurs

(dans Codex) — Load debug session and continue from where Claude left off.✓ Copié

→ Codex résume le snapshot et propose l'étape suivante

Résultat : Changement d'agent sans douleur en cours de tâche.

Pièges

Le snapshot est trop vague ; le nouvel agent repart de zéro — L'outil snapshot de Memorix demande : hypothèse, preuves, prochaine étape — remplissez les trois

Combinaisons

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

memorix-mcp + github

Miroir des mémoires vers un fichier adr.json commité pour le partage en équipe

memorix-mcp + filesystem

Sauvegarder la base Memorix locale

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
save	content: str, tags: str[]	Persister un fait / décision / snapshot	gratuit
recall	query?, tags?, limit?	Apporter du contexte pertinent dans la tâche actuelle	gratuit
update	id, content	Corriger ou affiner une mémoire existante	gratuit
decay	older_than_days	Nettoyage périodique	gratuit

Coût et limites

Coût d'exécution

Quota d'API: SQLite local — limité par le disque
Tokens par appel: 100 à 500 par rappel
Monétaire: Gratuit ; sync cloud (si utilisée) varie
Astuce: Exécutez decay hebdomadairement pour que les rappels retournent un contexte récent et compact, pas des notes de débogage vieilles de 6 mois

Sécurité

Permissions, secrets, portée

Stockage des identifiants : SQLite local par défaut ; sync cloud nécessite une clé API

Sortie de données : Local uniquement par défaut

Les mémoires peuvent contenir des secrets (ex. « nous utilisons la clé API XYZ ») — révisez avant d'exporter / commiter

Dépannage

Erreurs courantes et correctifs

Le rappel ne retourne rien de pertinent

Vérifiez que les tags correspondent — Memorix utilise les filtres de tags ET le texte flou

Vérifier : Exécutez sans filtre pour voir toutes les mémoires

Erreur de DB verrouillée

Plusieurs agents écrivent simultanément — Memorix utilise WAL ; assurez-vous que la version est >= 0.4

L'import échoue

Schéma incompatible entre les versions d'export et d'import — mettez à jour les deux d'abord

Alternatives

Memorix vs autres

Alternative	Quand l'utiliser	Compromis
doobidoo/mcp-memory-service	Vous voulez des fonctionnalités plus riches comme le graphe de connaissance et la consolidation	Plus lourd ; Memorix est intentionnellement minimal
OpenAI Memory / Anthropic Memory	Vous n'utilisez qu'un seul fournisseur	Limité à ce fournisseur ; Memorix est cross-agent

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills