Aller au contenu principal

Connecter Claude à Mnemosyne (MCP)

Votre mémoire peut devenir un outil que vos outils IA utilisent. Le paquet @mnemosyne_os/mcp (MIT) est un serveur Model Context Protocol qui transforme votre installation locale de Mnemosyne OS en couche mémoire interrogeable pour Claude Desktop, Claude Code, Cursor, Hermes Agent — tout agent qui parle MCP.

Une fois connecté, votre agent peut :

  • Interroger votre code, vos décisions, vos notes d'architecture et votre historique git avec un vrai classement sémantique ;
  • Persister de nouvelles décisions et intuitions, que les sessions futures retrouveront ;
  • Reprendre un projet exactement où vous l'aviez laissé ;
  • Filtrer par nature de mémoire (ARCHITECTURE, SOURCE_CODE, GIT, BUGFIX…).

Tout reste sur votre machine. Le MCP est un pont mince — il ne stocke rien lui-même ; toutes les données vivent dans vos coffres Mnemosyne OS, et l'agent ne voit que les coffres que vous autorisez.

Il tourne sur lui-même

La vidéo de la Neural Map de ce wiki, c'est Mnemosyne qui se souvient de son propre développement — et ce wiki lui-même est écrit par un agent connecté à travers ce MCP précis.

Prérequis

  1. Mnemosyne OS lancé — l'app possède vos coffres et expose la passerelle locale à laquelle le MCP parle. Le pont ne fonctionne que quand l'app est ouverte.
  2. Node.js ≥ 18.

Claude Desktop

Settings → Developer → Edit config (claude_desktop_config.json), ajoutez :

{
"mcpServers": {
"mnemosyne": {
"command": "npx",
"args": ["-y", "@mnemosyne_os/mcp"],
"env": {
"MNEMO_DEFAULT_VAULT": "DEV",
"MNEMO_VAULTS": "DEV,PERSONAL,SOCIAL"
}
}
}
}

Quittez complètement Claude Desktop et relancez-le (depuis l'icône de la barre système, pas juste la fenêtre). Le serveur mnemosyne apparaît dans Settings → Developer → Local MCP Servers avec le badge running.

Claude Code

Ajoutez .mcp.json à la racine de votre projet avec le même bloc, puis rechargez la session :

{
"mcpServers": {
"mnemosyne": {
"command": "npx",
"args": ["-y", "@mnemosyne_os/mcp"],
"env": {
"MNEMO_DEFAULT_VAULT": "DEV",
"MNEMO_VAULTS": "DEV,PERSONAL,SOCIAL"
}
}
}
}

Cursor

Le même bloc encore, dans .cursor/mcp.json.

Hermes Agent

Hermes embarque le support MCP — rien à installer de plus. La recette vit dans le README du paquet.

Vous restez la porte

MNEMO_VAULTS nomme les coffres que l'agent peut voir — rien d'autre n'est atteignable, et les coffres en protection Maximum gardent leurs garanties. Les écritures passent par les mêmes portes gouvernées que tout le reste. Votre conversation claude.ai ne voit jamais votre code — seulement les chroniques que vous autorisez.