Connecter Claude à Mnemosyne OS (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, et tout autre 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 qui 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 OS 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

Mnemosyne OS lancé, pour les outils de mémoire. L'app possède vos coffres et expose la passerelle locale à laquelle le MCP parle. Trois outils marchent app fermée : ceux qui lisent ce que les autres agents de code ont écrit sur cette machine (voir plus bas).
Node.js ≥ 18.

Claude Desktop, en un clic

Téléchargez Mnemosyne-OS-MCP-2.1.0.mcpb (4,1 Mo, ou la plus récente sur la page des versions), ouvrez Claude Desktop → Réglages → Extensions, et déposez le fichier dans ce panneau. C'est toute l'installation. Les outils apparaissent aussitôt, et le même panneau propose trois réglages facultatifs : coffre par défaut, autres coffres, et le port sur lequel l'application écoute.

Claude Desktop affiche d'abord un avertissement rouge développeur non vérifié. Tout paquet non signé le déclenche.

Le double-clic ne fait rien sur une installation du Microsoft Store

Une application du Store n'enregistre pas l'extension .mcpb auprès de Windows, donc le fichier ne s'ouvrira pas tout seul. Déposez-le dans le panneau Extensions.

Claude Desktop, par le fichier de configuration

Si vous préférez ne pas installer d'extension :

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 plus une ligne, puis rechargez la session :

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

La dernière ligne transmet au serveur l'identifiant de votre propre session. Un serveur MCP stdio ne reçoit que l'env que sa config déclare : sans elle, les outils qui listent les agents de cette machine ne peuvent pas marquer quelle ligne est la vôtre, et ils le disent en une phrase au lieu de deviner.

Cursor

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

Hermes Agent

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

Ce que votre agent obtient

Vingt-neuf outils, en sept familles. Vingt-cinq arrivent dans une install par défaut ; les outils de voix et celui d'effacement s'arment à la main avec une variable d'environnement. La référence complète des paramètres est dans le README du paquet, et la version courte de ce tableau vit sur mnemosyne-os.io/mcp.

Famille	Outils	App ouverte requise
Mémoire	`mnemosyne_memory_query`, `mnemosyne_memory_ask`, `mnemosyne_vault_list`, `mnemosyne_memory_ingest`, `mnemosyne_resonance_list`, `mnemosyne_dream_bridges`, `mnemosyne_spine_assignments`, `mnemosyne_git_log`, `mnemosyne_position_get`, `mnemosyne_position_update`, `mnemosyne_about`	oui
To-do et Agenda	`mnemosyne_todo_add`, `mnemosyne_todo_list`, `mnemosyne_todo_update`, `mnemosyne_todo_categories`, `mnemosyne_agenda_add`, `mnemosyne_agenda_list`, `mnemosyne_agenda_update`, `mnemosyne_agenda_remove`	sur une install dev, le démon sans fenêtre les sert app fermée ; une install npm a besoin de l'app
Les autres agents de cette machine	`mnemosyne_agent_list`, `mnemosyne_agent_collisions`, `mnemosyne_agent_files`	non : ils lisent les transcripts que votre harnais écrit déjà, jamais leur contenu
Cockpit	`mnemosyne_cockpit_update`	oui : une carte d'état de cette session sur votre plateau
Pheme	`mnemosyne_pheme_watch`, `mnemosyne_pheme_radar`	oui : le radar est aussi frais que le dernier scan que vous avez lancé, jamais plus
Voix	`mnemosyne_voice_list`, `mnemosyne_voice_speak`, `mnemosyne_voice_status`	oui, derrière `MNEMO_VOICE=1`
Effacement	`mnemosyne_memory_forget`	oui, derrière `MNEMO_FORGET=1` : définitif, sans corbeille et sans copie gardée

mnemosyne_agent_collisions est celui à appeler avant un commit : il dit si une autre session d'agent est vivante sur le même projet et la même branche, parce que l'index git est partagé par tous les processus d'un même arbre.

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. La session de votre agent ne voit que les chroniques que vous autorisez.

L'autre sens

Cette page donne à votre agent le droit de lire votre mémoire. À partir de la 1.4.3, vous pouvez aussi la nourrir : branchez un coffre sur les notes que votre agent écrit pour lui-même, et interrogez votre mémoire sur ce qu'il sait. Voyez connecter la mémoire de votre agent de code.

Et le même pont atteint votre To-do et votre Agenda : depuis la 1.4.4 l'agent dépose les tâches que vous avez décidées, et depuis la 1.4.5 il les relit, les modifie, les coche ou les retire, et fait pareil avec vos rendez-vous, app fermée comprise. Voyez des tâches depuis votre agent de code.

Prérequis​

Claude Desktop, en un clic​

Claude Desktop, par le fichier de configuration​

Claude Code​

Cursor​

Hermes Agent​

Ce que votre agent obtient​

Vous restez la porte​

L'autre sens​