memcord

MEMCORD v4.3.6 (servidor mcp)

Este servidor MCP autoalojado y centrado en la privacidad te ayuda a organizar el historial de chats, resumir mensajes, buscar en conversaciones pasadas con IA — y mantiene todo seguro y completamente bajo tu control.

Nunca Pierdas el Contexto de Nuevo

Transforma tus conversaciones de Claude en una base de conocimiento buscable y organizada que crece contigo

Novedades en v4.3.6 — elimina dos dependencias innecesarias (pandas, python-magic) de una instalación limpia; la importación CSV/TSV ahora usa la biblioteca estándar en lugar de pandas.

Tabla de Contenidos

• Beneficios Principales
• Requisitos Previos
• Inicio Rápido
• Mantener Memcord Actualizado
• Usar Memcord
• Ruta de Almacenamiento Personalizada
• Motores de Resumen
• Configuración del IDE
• Documentación

Beneficios Principales

• Memoria Infinita - Claude recuerda todo a través de conversaciones ilimitadas con resumen automático inteligente
• Tus Datos, Tu Control - Almacenamiento 100% local sin dependencias en la nube ni preocupaciones de privacidad
• Organización Sin Esfuerzo - Ranuras de memoria por proyecto con navegación de línea de tiempo y etiquetado inteligente
• Fusión Inteligente - Combina automáticamente conversaciones relacionadas mientras elimina duplicados

Requisitos Previos

Inicio Rápido

macOS / Linux:

curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash

Windows (PowerShell):

irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex

Esto hará:

• ✅ Descargar y configurar memcord
• ✅ Configurar el entorno virtual de Python usando uv
• ✅ Generar archivos de configuración MCP específicos de la plataforma
• ✅ Configurar Claude Desktop, Claude Code, VSCode y Antigravity IDE

Mantener Memcord Actualizado

Vuelve a ejecutar el mismo comando de instalación de Inicio Rápido desde la misma carpeta donde memcord está instalado — detecta una instalación existente y la actualiza en su lugar en lugar de clonar una copia nueva:

macOS / Linux:

curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash

Windows (PowerShell):

irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex

Esto hará:

• ✅ Obtener los últimos cambios (solo avance rápido — aborta de forma segura si tienes ediciones locales)
• ✅ Reutilizar tu entorno virtual existente y actualizar dependencias
• ✅ Regenerar archivos de configuración MCP
• ✅ Dejar tus datos de memoria (memory_slots/) y configuraciones generadas intactos

cd /path/to/memcord
git pull
uv pip install -e . --upgrade
uv run python scripts/generate-config.py  # Regenerate configs

# Optional: Enable auto-save hooks (new in v2.5.0)
uv run python scripts/generate-config.py --install-hooks

La bandera --install-hooks es idempotente — se fusiona en .claude/settings.json existente sin sobrescribir otras configuraciones o hooks.

Cambiar una Instalación Existente a Alcance Global

Las instalaciones nuevas registran memcord globalmente (~/.claude.json) por defecto — disponible en cada proyecto. Si tienes una instalación más antigua que sigue siendo de alcance de proyecto (un .mcp.json local), cámbiala explícitamente — volver a ejecutar el actualizador solo no hará esto por ti, ya que detecta automáticamente y preserva una configuración existente de alcance de proyecto a propósito:

cd /path/to/memcord
uv run python scripts/generate-config.py --scope user

Verifica desde un directorio de proyecto diferente: claude mcp list debería mostrar memcord ahora. El .mcp.json original se deja en su lugar y sigue funcionando (inofensivo, solo redundante) — elimínalo solo si quieres que ese directorio deje de fijar su propia copia local en lugar de recurrir a la global.

Instalar Comandos Slash Globalmente

Los 17 comandos slash memcord-* vienen en .claude/commands/ y ya son utilizables desde dentro del checkout de memcord en el momento que lo clonas. Para usarlos desde cualquier directorio de proyecto, instálalos globalmente en ~/.claude/commands/:

uv run python scripts/generate-config.py --manage-commands   # interactive picker
uv run python scripts/generate-config.py --commands all      # non-interactive: install all

Las instalaciones nuevas preguntan por esto automáticamente (se omite cuando no es interactivo, p. ej. curl | bash). Vuelve a ejecutar en cualquier momento para cambiar tu selección — solo se agregan o eliminan los propios archivos de comandos de memcord.

Usar Memcord

Configuración Inicial (Proyecto Nuevo)

# 1. Once you are in claude code, initialize the project with a memory slot (one-time setup)
memcord_init "." "my-project-name"
# OR
memcord_init "my_project_name"
# Creates .memcord file containing "my-project-name"

# 2. Start saving your conversations
/memcord-save-progress  # Auto-detects slot from .memcord file

Sesiones Posteriores (Volver al Proyecto)

# Just use slash commands - no slot name needed!
/memcord-read           # Reads from bound slot
/memcord-save           # Saves to bound slot
/memcord-save-progress  # Summarizes and saves

Búsqueda y Consultas (Llamadas Directas a Herramientas)

memcord_select_entry "2 hours ago"    # Jump to a point in the timeline
memcord_list                          # List all slots
memcord_search "API design"           # Full-text search
memcord_query "What did we decide?"   # Natural language query

Consulta la Referencia Completa de Herramientas para las 23 herramientas con parámetros completos y ejemplos.

Cómo Funciona la Detección Automática

Todas las operaciones de lectura y escritura siguen la misma prioridad de resolución de ranura:

1. Argumento explícito slot_name (siempre gana)
2. Ranura actualmente activa (establecida por memcord_use o memcord_name)
3. Archivo de enlace .memcord en el directorio de trabajo actual

Cuando se usa el enlace .memcord y la ranura ya existe, también se auto-activa para el resto de la sesión — así las operaciones posteriores omiten la re-detección automáticamente.

Esto significa que después de memcord_init, una sesión nueva (sin necesidad de llamar a memcord_use) enrutará correctamente memcord_save, memcord_save_progress, memcord_configure y memcord_read a la ranura vinculada.

Ruta de Almacenamiento Personalizada

Apunta el archivo de datos de una ranura a cualquier directorio — p. ej. una carpeta de Dropbox/OneDrive — para compartirlo entre dispositivos, mediante memcord_configure. Una vez vinculado, la configuración de la ranura (motor de resumen, etc.) viaja con los datos también, así cada dispositivo que comparte la carpeta ve la misma configuración.

Nueva memoria en una ruta externa:

memcord_name "shared_slot"
memcord_configure action="set" key="custom_storage_path" value="D:\Dropbox\shared"
memcord_save "..."   # writes directly to the external path

Migrar una memoria existente:

memcord_configure action="set" key="custom_storage_path" value="D:\Dropbox\shared"
# Existing data is moved automatically — memcord_read/memcord_list keep working

Cada dispositivo necesita ejecutar el comando set una vez con su propia ruta local a la carpeta compartida. Consulta Referencia de Herramientas — memcord_configure para detalles de migración/colisiones.

Motores de Resumen

Memcord soporta cuatro motores de resumen conectables (nltk, sumy, semantic, transformers), intercambiables por ranura mediante memcord_configure action="set" key="summarizer_backend" value="..." — sin necesidad de reiniciar. Las ranuras nuevas usan sumy por defecto (sin descargas); las ranuras existentes mantienen nltk para compatibilidad hacia atrás.

Consulta Referencia de Herramientas — memcord_configure y Guía de Funciones para la comparación completa de motores, instrucciones de instalación y la anulación de variable de entorno MEMCORD_SUMMARIZER.

Configuración del IDE

El instalador configura automáticamente todos los IDEs compatibles. Para configuración manual o solución de problemas, consulta las guías detalladas:

Instalación Manual

git clone https://github.com/ukkit/memcord.git
cd memcord
uv venv && uv pip install -e .
uv run python scripts/generate-config.py

Consulta la Guía Completa de Instalación para actualizaciones, opciones avanzadas y comandos personalizados.

Documentación

Si encuentras útil este proyecto, considera:

• ⭐ Dar una estrella al repositorio en GitHub
• ☕ Apoyar el Desarrollo
• 🐛 Reportar errores y sugerir funciones

Licencia MIT — consulta el archivo LICENSE para más detalles.