Saltar al contenido principal

Conectar Claude a Mnemosyne (MCP)

Tu memoria puede ser una herramienta que usan tus herramientas de IA. El paquete @mnemosyne_os/mcp (MIT) es un servidor Model Context Protocol que convierte tu instalación local de Mnemosyne OS en una capa de memoria consultable para Claude Desktop, Claude Code, Cursor, Hermes Agent — cualquier agente que hable MCP.

Una vez conectado, tu agente puede:

  • Consultar tu código, decisiones, notas de arquitectura e historial git con verdadero ranking semántico;
  • Persistir nuevas decisiones e ideas, que las sesiones futuras recuperarán;
  • Retomar un proyecto exactamente donde lo dejaste;
  • Filtrar por la naturaleza de las memorias (ARCHITECTURE, SOURCE_CODE, GIT, BUGFIX…).

Todo queda en tu máquina. El MCP es un puente delgado — no almacena nada por sí mismo; todos los datos viven en tus bóvedas de Mnemosyne OS, y el agente solo ve las bóvedas que tú autorizas.

Corre sobre sí mismo

El vídeo del Neural Map de este wiki es Mnemosyne recordando su propio desarrollo — y este mismo wiki está escrito por un agente conectado a través de este mismo MCP.

Requisitos

  1. Mnemosyne OS en marcha — la app posee tus bóvedas y expone la pasarela local con la que habla el MCP. El puente solo funciona con la app abierta.
  2. Node.js ≥ 18.

Claude Desktop

Settings → Developer → Edit config (claude_desktop_config.json), añade:

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

Cierra Claude Desktop por completo y relánzalo (desde el icono de la bandeja, no solo la ventana). El servidor mnemosyne aparece en Settings → Developer → Local MCP Servers con la insignia running.

Claude Code

Añade .mcp.json en la raíz de tu proyecto con el mismo bloque, y recarga la sesión:

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

Cursor

El mismo bloque otra vez, en .cursor/mcp.json.

Hermes Agent

Hermes trae soporte MCP de serie — nada más que instalar. La receta vive en el README del paquete.

Tú sigues siendo la puerta

MNEMO_VAULTS nombra las bóvedas que el agente puede ver — nada más es alcanzable, y las bóvedas con protección Maximum conservan sus garantías. Las escrituras pasan por las mismas puertas gobernadas que todo lo demás. Tu conversación de claude.ai nunca ve tu código — solo las crónicas que autorizas.