memory-mcp

🧠 Servidor MCP de Memoria

Memoria persistente y caché de ventana de contexto para conversaciones de LLM. Guarda, recupera y gestiona memorias con archivado inteligente de contexto. Almacenamiento respaldado por MongoDB.

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona gestión de memoria y caché de ventana de contexto para entornos de codificación de IA como Cursor y Claude Desktop.

¿Por qué usar Memory MCP?

• 💾 Almacenamiento persistente – Memoria respaldada por MongoDB que sobrevive a las sesiones
• 🧠 Caché de contexto – Archivado y recuperación inteligente del contexto de conversación
• 🏷️ Búsqueda por etiquetas – Organiza y encuentra memorias por etiquetas
• 📊 Puntuación de relevancia – Puntúa automáticamente la relevancia del contenido archivado
• ⚡ Configuración fácil – Instalación con un clic en Cursor o configuración manual simple

Inicio rápido

¿Listo para añadir memoria a tu flujo de trabajo de IA? Instala en segundos:

Instalar en Cursor (Recomendado):

🔗 Instalar en Cursor

O instalar manualmente:

npm install -g @jamesanz/memory-mcp
# Or from source:
git clone https://github.com/JamesANZ/memory-mcp.git
cd memory-mcp && npm install && npm run build

Características

Herramientas básicas de memoria

• save-memories – Guarda memorias en la base de datos (sobrescribe las existentes)
• get-memories – Recupera todas las memorias almacenadas
• add-memories – Añade nuevas memorias sin sobrescribir
• clear-memories – Elimina todas las memorias almacenadas

Caché de ventana de contexto

• archive-context – Archiva el contexto de conversación con etiquetas
• retrieve-context – Recupera el contexto archivado relevante
• score-relevance – Puntúa la relevancia del contenido archivado
• create-summary – Crea resúmenes del contenido archivado
• get-conversation-summaries – Obtén todos los resúmenes de una conversación
• search-context-by-tags – Busca contenido archivado por etiquetas

Instalación

Cursor (Un clic)

Haz clic en el enlace de instalación anterior o usa:

cursor://anysphere.cursor-deeplink/mcp/install?name=memory-mcp&config=eyJtZW1vcnktbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiQGphbWVzYW56L21lbW9yeS1tY3AiXX19

Instalación manual

Requisitos: Node.js 18+, npm, MongoDB

# Clone and build
git clone https://github.com/JamesANZ/memory-mcp.git
cd memory-mcp
npm install
npm run build

# Set MongoDB connection string
export MONGODB_URI="mongodb://localhost:27017"

# Run server
npm start

Claude Desktop

Añade a claude_desktop_config.json:

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

{
  "mcpServers": {
    "memory-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/memory-mcp/build/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017"
      }
    }
  }
}

Reinicia Claude Desktop después de la configuración.

Configuración

Establece la cadena de conexión de MongoDB:

export MONGODB_URI="mongodb://localhost:27017"

Predeterminado: mongodb://localhost:27017

Ejemplos de uso

Guardar memorias

Guarda memorias de una conversación:

{
  "tool": "save-memories",
  "arguments": {
    "memories": ["User prefers TypeScript", "User works on blockchain projects"],
    "llm": "claude",
    "userId": "user123"
  }
}

Recuperar memorias

Obtén todas las memorias almacenadas:

{
  "tool": "get-memories",
  "arguments": {}
}

Archivar contexto

Archiva el contexto de conversación cuando se vuelve demasiado largo:

{
  "tool": "archive-context",
  "arguments": {
    "conversationId": "conv-123",
    "contextMessages": ["Message 1", "Message 2"],
    "tags": ["coding", "typescript"],
    "llm": "claude"
  }
}

Recuperar contexto relevante

Obtén contenido archivado relevante para la conversación actual:

{
  "tool": "retrieve-context",
  "arguments": {
    "conversationId": "conv-123",
    "tags": ["coding"],
    "minRelevanceScore": 0.5,
    "limit": 10
  }
}

Caché de ventana de contexto

El sistema automáticamente:

• Archiva contenido cuando el uso del contexto alcanza el 80%
• Recupera contenido relevante cuando el uso cae por debajo del 30%
• Puntúa la relevancia usando superposición de palabras clave
• Crea resúmenes para condensar conversaciones largas

Casos de uso

• Conversaciones largas – Gestiona ventanas de contexto para sesiones extendidas
• Persistencia de memoria – Guarda información importante entre sesiones
• Recuperación de contexto – Trae de vuelta conversaciones pasadas relevantes
• Proyectos de investigación – Organiza y etiqueta conversaciones de investigación

Detalles técnicos

Construido con: Node.js, TypeScript, MCP SDK, MongoDB
Dependencias: @modelcontextprotocol/sdk, mongodb, zod
Plataformas: macOS, Windows, Linux

Almacenamiento: MongoDB (predeterminado: mongodb://localhost:27017)

Contribuciones

⭐ Si este proyecto te ayuda, ¡por favor dale una estrella en GitHub! ⭐

¡Las contribuciones son bienvenidas! Por favor abre un issue o envía una pull request.

Licencia

ISC

Soporte

Si encuentras útil este proyecto, considera apoyarlo:

⚡ Lightning Network

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f