mcp-sqlite-graph-memory

Servidor universal del Model Context Protocol (MCP) que ofrece memoria dinámica de grafo de conocimiento de código respaldada por SQLite para asistentes de codificación con IA y agentes autónomos.

Detecta automáticamente los espacios de trabajo activos, analiza AST de múltiples lenguajes y dependencias estructurales en un grafo de conocimiento SQLite local aislado, y expone herramientas MCP de precisión para inspeccionar símbolos, calcular las rutas de llamada/importación más cortas y navegar por las topologías del código.

🌟 Capacidades clave

• Cero dependencias en tiempo de ejecución: Escrito íntegramente con la biblioteca estándar de Python (ast, sqlite3, json, re, hashlib, threading).

• Aislamiento dinámico de múltiples espacios de trabajo: Genera hashes SHA-256 deterministas por raíz de espacio de trabajo; almacena bases de datos SQLite aisladas en ~/.mcp-graph-memory/storage/graph_<hash>.db.

• Caché incremental de stat: Verifica el mtime y el size de los archivos para lograr omisiones de menos de un milisegundo en archivos sin cambios durante el reindexado.

• Analizador de AST y estructural multilenguaje:

  • Python: Clases, métodos, funciones, funciones asíncronas, decoradores, importaciones (from x import y, import z), jerarquías de herencia, puntos de llamada.

  • TypeScript / JavaScript: Clases, interfaces, tipos, funciones, funciones flecha, importaciones/exportaciones ES6, require() de CommonJS.

  • Go: Paquetes, importaciones, estructuras, interfaces, funciones, métodos.

  • Rust: Módulos, estructuras, enums, traits, bloques impl, firmas fn.

  • C / C++ / Java / PHP / Ruby / Kotlin / Swift / Shell: Estructuras, clases, definiciones.

• Protección contra congelaciones e inanición de CPU:

  • Inicialización asíncrona del demonio sin bloqueo.

  • Transporte stdio sin espera activa (for raw_line in sys.stdin:).

  • Lista de ignorados estricta para node_modules/, .git/, .venv/, pesos binarios y blobs de caché.

🛠️ Especificación de herramientas MCP

🚀 Instalación

git clone https://github.com/Luiguard/mcp-sqlite-graph-memory.git ~/.mcp-graph-memory
chmod +x ~/.mcp-graph-memory/server.py

🔌 Guías de integración

1. Integración con Google Antigravity

Opción A: Configuración global (recomendada)

Añade graph-memory a tu archivo de configuración global de MCP de Antigravity en ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "/home/YOUR_USER/.mcp-graph-memory/server.py"
      ]
    }
  }
}

(Reemplaza /home/YOUR_USER con la ruta real de tu directorio $HOME o usa una ruta absoluta).

Opción B: Configuración a nivel de espacio de trabajo

Para la activación por proyecto, coloca mcp_config.json dentro de la raíz de tu espacio de trabajo en .agents/mcp_config.json:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "${workspaceFolder}/.mcp-graph-memory/server.py"
      ]
    }
  }
}

2. Integración con Claude Desktop

Localiza tu configuración de Claude:

• Linux: ~/.config/Claude/claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade la definición del servidor:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "/path/to/mcp-sqlite-graph-memory/server.py"
      ]
    }
  }
}

3. Integración con Cursor / VSCode / Windsurf

En .cursor/mcp.json o .vscode/mcp.json:

{
  "mcpServers": {
    "graph-memory": {
      "command": "python3",
      "args": [
        "/path/to/mcp-sqlite-graph-memory/server.py"
      ]
    }
  }
}

🔧 Variables de entorno

🧪 Verificación y pruebas

Ejecuta la suite de integración automatizada:

python3 test_server.py

📄 Licencia

Licencia MIT - Copyright (c) 2026 Benjamin Leimer. Consulta LICENSE para más detalles.