Soluciones para problemas comunes de MemoryGraph.

Diagnosticos Rapidos

# Verificar instalacion
which memorygraph
memorygraph --version

# Ejecutar verificacion de salud
memorygraph --health

# Mostrar configuracion
memorygraph --show-config

# Verificar estado MCP (Claude Code)
claude mcp list

Problemas Comunes

Command not found: memorygraph

El binario memorygraph no esta en tu PATH.

# Si usas pipx, asegurate que PATH este configurado
pipx ensurepath
# Reinicia tu terminal

# Verifica donde esta instalado
python3 -c "import shutil; print(shutil.which('memorygraph') or 'No esta en PATH')"

# Agregar a PATH manualmente (bash)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Agregar a PATH manualmente (zsh)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Fallo de Conexion del Servidor MCP

Claude Code muestra "Failed to connect" para memorygraph.

# Probar el servidor MCP manualmente
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}},"id":1}' | memorygraph

# Deberia devolver una respuesta JSON con capacidades

# Si falla, verifica la version de Python
python3 --version  # Debe ser 3.10+

# Eliminar y re-agregar el servidor
claude mcp remove memorygraph
claude mcp add memorygraph memorygraph

Falla la Verificacion de Salud

# Ejecutar verificacion de salud con salida detallada
memorygraph --health

# Fallas comunes:

# Timeout - backend no responde
# Solucion: Verificar si el backend esta corriendo, aumentar timeout
memorygraph --health --health-timeout 10.0

# Base de datos bloqueada (SQLite)
# Solucion: Cerrar otras conexiones
lsof ~/.local/share/memorygraph/*.db

# Conexion rechazada
# Solucion: Verificar credenciales del backend

Error de Version de Python

MemoryGraph requiere Python 3.10 o superior.

# Verificar version de Python
python3 --version

# En macOS, instalar con Homebrew
brew install python@3.11

# En Ubuntu/Debian
sudo apt update
sudo apt install python3.11

# Reinstalar memorygraph con Python correcto
pipx uninstall memorygraphMCP
pipx install memorygraphMCP --python python3.11

Errores de Permiso Denegado

# Problema de permisos del directorio de datos
ls -la ~/.local/share/memorygraph/

# Corregir permisos
chmod 755 ~/.local/share/memorygraph/
chmod 644 ~/.local/share/memorygraph/*.db

# O usar directorio de datos personalizado
export MEMORYGRAPH_DATA_DIR=/ruta/con/permisos

Modo Debug

Habilitar logging detallado para depuracion:

# Establecer nivel de log a DEBUG
export MEMORYGRAPH_LOG_LEVEL=DEBUG
memorygraph --health

# O al agregar a Claude Code
claude mcp add memorygraph memorygraph --env MEMORYGRAPH_LOG_LEVEL=DEBUG

Reiniciar Configuracion

Comenzar de nuevo si las cosas estan rotas:

# Eliminar configuracion del servidor MCP
claude mcp remove memorygraph

# Desinstalar y reinstalar
pipx uninstall memorygraphMCP
pipx install memorygraphMCP

# Re-agregar a Claude Code
claude mcp add memorygraph memorygraph

# Reiniciar Claude Code
exit
claude

Obtener Ayuda