mcp-sqlite-graph-memory

Universeller Model Context Protocol (MCP)-Server, der dynamisches SQLite-gestütztes Code-Wissensgraph-Gedächtnis für KI-Codierungsassistenten und autonome Agenten bereitstellt.

Erkennt automatisch aktive Workspaces, parst mehrsprachige ASTs und strukturelle Abhängigkeiten in einen isolierten lokalen SQLite-Wissensgraphen und stellt präzise MCP-Tools bereit, um Symbole zu untersuchen, kürzeste Aufruf-/Importpfade zu berechnen und Code-Topologien zu navigieren.

🌟 Hauptfunktionen

• Null Laufzeitabhängigkeiten: Vollständig in der Python-Standardbibliothek geschrieben (ast, sqlite3, json, re, hashlib, threading).

• Dynamische Multi-Workspace-Isolation: Generiert deterministische SHA-256-Hashes pro Workspace-Root; speichert isolierte SQLite-Datenbanken in ~/.mcp-graph-memory/storage/graph_<hash>.db.

• Inkrementelles Stat-Caching: Überprüft mtime und size von Dateien, um bei unveränderten Dateien während der Neuindizierung Überspringungen im Sub-Millisekunden-Bereich zu erreichen.

• Mehrsprachiger AST- & Strukturparser:

  • Python: Klassen, Methoden, Funktionen, asynchrone Funktionen, Dekorateure, Importe (from x import y, import z), Vererbungshierarchien, Aufrufstellen.

  • TypeScript / JavaScript: Klassen, Interfaces, Typen, Funktionen, Pfeilfunktionen, ES6-Importe/-Exporte, CommonJS require().

  • Go: Pakete, Importe, Structs, Interfaces, Funktionen, Methoden.

  • Rust: Module, Structs, Enums, Traits, impl-Blöcke, fn-Signaturen.

  • C / C++ / Java / PHP / Ruby / Kotlin / Swift / Shell: Structs, Klassen, Definitionen.

• Schutz vor Einfrieren & CPU-Verhungern:

  • Nicht blockierende asynchrone Daemon-Initialisierung.

  • Nicht ausgelasteter Stdio-Transport (for raw_line in sys.stdin:).

  • Strikte Ignorierliste für node_modules/, .git/, .venv/, binäre Gewichte und Cache-Blobs.

🛠️ MCP-Tools-Spezifikation

🚀 Installation

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

🔌 Integrationsanleitungen

1. Google-Antigravity-Integration

Option A: Globale Konfiguration (Empfohlen)

Fügen Sie graph-memory zu Ihrer globalen Antigravity-MCP-Konfigurationsdatei unter ~/.gemini/config/mcp_config.json hinzu:

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

(Ersetzen Sie /home/YOUR_USER durch Ihren tatsächlichen $HOME-Verzeichnispfad oder verwenden Sie einen absoluten Pfad).

Option B: Konfiguration auf Workspace-Ebene

Für die Aktivierung pro Projekt platzieren Sie mcp_config.json im Workspace-Root unter .agents/mcp_config.json:

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

2. Claude-Desktop-Integration

Suchen Sie Ihre Claude-Konfiguration:

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

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

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

Fügen Sie die Serverdefinition hinzu:

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

3. Cursor-/VSCode-/Windsurf-Integration

In .cursor/mcp.json oder .vscode/mcp.json:

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

🔧 Umgebungsvariablen

🧪 Verifizierung & Tests

Führen Sie die automatisierte Integrationssuite aus:

python3 test_server.py

📄 Lizenz

MIT-Lizenz - Copyright (c) 2026 Benjamin Leimer. Siehe LICENSE für Details.