MCP Memory Visualizer

Herramientas de Visualización de Memoria de Claude MCP

Utilidades de visualización de grafos para explorar y analizar los datos de memoria de Claude capturados por el servidor Memory MCP de Anthropic.

🌐 ¡Pruébalo Ahora!

Lanzar Visualizador Web Interactivo →

¡No se necesita instalación! Sube tu archivo memory.json directamente en tu navegador.

• 🔒 100% Privado - Todo el procesamiento ocurre localmente en tu navegador
• 📊 Interactivo - Arrastra, haz zoom, busca y explora
• 🎨 Hermoso - Entidades codificadas por colores con animaciones fluidas
• 📱 Funciona en Todas Partes - No requiere Python ni dependencias

Resumen

Este repositorio proporciona tres formas de visualizar los datos de memoria de Claude:

1. 🌐 Visualizador Web - Visualización interactiva basada en navegador (¡sin necesidad de instalación!)
2. 📊 Análisis Estático en Python - Análisis estadístico basado en NetworkX y grafos de alta resolución
3. 🔍 Python Interactivo - Visualización en navegador impulsada por PyVis con procesamiento en Python

Perfecto para:

• Análisis de Memoria: Comprender qué recuerda Claude sobre tus conversaciones
• Mapeo de Conocimiento: Visualizar relaciones y conexiones entre entidades
• Limpieza de Memoria: Identificar entidades redundantes o dispersas para optimización
• Investigación: Explorar cómo los sistemas de memoria de IA organizan la información

Inicio Rápido

Opción 1: Visualizador Web (¡La Más Fácil!)

Simplemente visita: https://dzivkovi.github.io/mcp-memory-visualizer/

• No se requiere instalación
• Funciona en cualquier dispositivo con navegador web
• Arrastra y suelta tu archivo memory.json
• 100% privado - todo el procesamiento ocurre en tu navegador

Opción 2: Herramientas Python

Para análisis avanzado y procesamiento por lotes:

# Install dependencies
pip install -r requirements.txt

# Run static analysis
python visualize_memory.py

# Run interactive Python version
python visualize_memory_interactive.py

Ubicación del Archivo de Memoria

Ubicación Predeterminada (Problemática)

El servidor Memory MCP almacena memory.json por defecto en:

C:\Users\[username]\AppData\Local\npm-cache\_npx\[hash]\node_modules\@modelcontextprotocol\server-memory\dist\memory.json

⚠️ Advertencia: Esta ubicación es temporal y se borra durante las limpiezas de caché de npm o actualizaciones de paquetes.

Configuración Recomendada

Configura siempre una ubicación persistente usando la variable de entorno MEMORY_FILE_PATH en tu configuración de Claude Desktop:

{
  "mcpServers": {
    "memory": {
      "command": "npx", 
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "C:\\Users\\[username]\\Documents\\claude-memory\\memory.json"
      }
    }
  }
}

Ubicaciones Seguras de Almacenamiento

• C:\Users\[username]\Documents\claude-memory\memory.json
• C:\Users\[username]\AppData\Roaming\claude-memory\memory.json
• C:\claude-memory\memory.json (requiere derechos de administrador)

Nota: Crea el directorio primero y usa dobles barras invertidas (\\) en rutas de Windows para un escape JSON adecuado.

Comparación de Herramientas

Característica	Visualizador Web	Python Estático	Python Interactivo
Instalación	Ninguna	Python + librerías	Python + librerías
Privacidad	100% local	Local	Local
Interactividad	Alta	Ninguna	Alta
Análisis	Visual	Estadístico	Ambos
Exportación	Captura de pantalla	PNG + estadísticas	HTML
Mejor Para	Exploración rápida	Investigación/informes	Análisis profundo

Datos de Demostración

El repositorio incluye un archivo memory.json de demostración con datos realistas pero ficticios que muestran:

• 16 entidades en 9 tipos diferentes (persona, tecnología, proyecto, etc.)
• 25 relaciones formando un grafo de conocimiento conectado
• Conexiones complejas entre investigación de IA, sistemas empresariales y colaboración académica
• Tamaños de nodo variados de 1 a 10 observaciones

Características

Visualizador Web

• Arrastrar y Soltar carga de archivos
• Búsqueda de entidades y observaciones
• Grafo Interactivo con simulación de física
• Panel de Detalles que muestra observaciones y relaciones
• Auto-diseño con controles de zoom
• Diseño centrado en la privacidad con mensajes claros

Análisis Estático en Python (visualize_memory.py)

• Estadísticas de red (nodos, aristas, componentes conectados)
• Análisis de centralidad (entidades más conectadas)
• Detección de redundancia (entidades similares, nodos dispersos)
• Visualización de grafos de alta resolución (300 DPI)
• Salida de análisis detallada en terminal

Python Interactivo (visualize_memory_interactive.py)

• Visualización interactiva basada en navegador
• Información sobre herramientas al pasar el cursor con detalles completos de entidades
• Posicionamiento de nodos basado en física
• Zoom, desplazamiento y arrastre de nodos
• Exportación HTML para compartir

Formato del Archivo de Memoria

Estas herramientas funcionan con archivos memory.json en formato JSONL (un objeto JSON por línea):

{"type": "entity", "name": "Python", "entityType": "technology", "observations": ["Used for data analysis", "Popular ML language"]}
{"type": "relation", "from": "Python", "to": "Data Science", "relationType": "used_in"}

Detalles Técnicos

Visualizador Web

• D3.js para visualización de datos potente
• Diseño de grafo dirigido por fuerzas
• Procesamiento en el lado del cliente para privacidad
• Diseño responsivo para todos los tamaños de pantalla

Herramientas Python

• NetworkX para análisis de grafos
• Matplotlib para visualización estática
• PyVis para salida HTML interactiva
• Algoritmos dirigidos por fuerzas para agrupación natural

Contribuciones

Siéntete libre de extender estas herramientas con características adicionales:

• Formatos de exportación (GraphML, GEXF, JSON)
• Opciones de filtrado (tipos de entidad, rangos de fechas)
• Métricas avanzadas (centralidad de intermediación, coeficientes de agrupamiento)
• Capacidades de edición de memoria

Créditos

Construido para explorar los datos de memoria de Claude de el servidor Memory MCP de Anthropic.

Filosofía: "La perfección se logra, no cuando no hay nada más que añadir, sino cuando no queda nada que quitar." - Antoine de Saint-Exupéry