RMANOV/sqlite-memory-mcp

Was macht sqlite-memory-mcp?

SQLite-gestützter MCP-Speicherserver mit WAL-Parallelsicherheit, FTS5-Suche, Sitzungsverfolgung, Aufgabenverwaltung und plattformübergreifender Bridge-Synchronisation

Übersicht

Dieses Projekt bietet einen MCP (Model Context Protocol) Speicherserver, der SQLite als Backend verwendet. Es unterstützt:

• WAL-Modus für gleichzeitige Lese-/Schreibzugriffe ohne Sperrkonflikte
• FTS5-Volltextsuche für schnelle Abfragen in großen Datenmengen
• Sitzungsverfolgung – speichert Kontext über mehrere Sitzungen hinweg
• Aufgabenverwaltung – Erstellen, Aktualisieren und Nachverfolgen von Aufgaben
• Bridge-Synchronisation zwischen verschiedenen Maschinen oder Instanzen

Funktionen

Funktion	Beschreibung
Speicher-API	Einfache CRUD-Operationen für Entitäten und Beziehungen
FTS5-Suche	Hochperformante Volltextsuche mit Rangfolge
WAL-Sicherheit	Parallele Zugriffe durch Write-Ahead Logging
Sitzungskontext	Automatische Speicherung und Wiederherstellung von Sitzungsdaten
Aufgabenmanager	Priorisierung, Status und Fälligkeitsdaten für Aufgaben
Bridge-Sync	Synchronisation zwischen Instanzen über verschlüsselte Verbindungen

Installation

npm install @rmanov/sqlite-memory-mcp
# oder
pip install sqlite-memory-mcp

Schnellstart

1. Starten Sie den Server:

   npx @rmanov/sqlite-memory-mcp server
   

2. Konfigurieren Sie Ihren KI-Agenten (z.B. Claude Code):

   {
     "mcpServers": {
       "sqlite-memory": {
         "command": "npx",
         "args": ["@rmanov/sqlite-memory-mcp", "server"]
       }
     }
   }
   

3. Nutzen Sie die bereitgestellten Tools:

   • memory_store – Daten speichern
   • memory_search – Schnellsuche via FTS5
   • session_manage – Sitzungskontext verwalten
   • task_create – Aufgaben anlegen
   • bridge_sync – Synchronisation auslösen

Konfiguration

Umgebungsvariable	Standardwert	Beschreibung
MEMORY_DB_PATH	./memory.db	Pfad zur SQLite-Datenbankdatei
BRIDGE_PORT	8080	Port für die Bridge-Synchronisation
BRIDGE_SECRET	–	Geheimer Schlüssel für verschlüsselte Syncs
FTS5_LIMIT	50	Maximale Anzahl von Suchergebnissen

Verwendung

Speicher-API

// Beispiel: Speichern einer Erinnerung
await memoryStore({
  type: "user_preference",
  content: { theme: "dark", language: "de" },
  tags: ["setting", "ui"]
});

Suche

// Beispiel: Volltextsuche
const results = await memorySearch("dark theme preferences");

Aufgabenverwaltung

// Beispiel: Aufgabe erstellen
await taskCreate({
  title: "SQLite-Backup konfigurieren",
  priority: "high",
  dueDate: "2025-06-01"
});

Bridge-Synchronisation

Die Bridge ermöglicht es, Speicherdaten zwischen verschiedenen Maschinen zu synchronisieren. Starten Sie auf der Empfängerseite einen Bridge-Server und verbinden Sie sich von der Senderseite.

# Empfänger (Server)
npx @rmanov/sqlite-memory-mcp bridge --port 8080 --secret mein-geheimnis

# Sender (Client)
npx @rmanov/sqlite-memory-mcp bridge --connect host:8080 --secret mein-geheimnis

Lizenz

MIT