mcp-Speicher-libsql

Ein leistungsstarkes, persistentes Speichersystem für das Model Context Protocol (MCP) auf Basis von libSQL. Dieser Server bietet Vektorsuchfunktionen und effiziente Wissensspeicherung mit libSQL als zugrunde liegendem Speicher.

Merkmale

🚀 Leistungsstarke Vektorsuche mit libSQL
💾 Dauerhafte Speicherung von Entitäten und Beziehungen
🔍 Semantische Suchfunktionen
🔄 Wissensgraphenverwaltung
🌐 Kompatibel mit lokalen und Remote-libSQL-Datenbanken
🔒 Sichere tokenbasierte Authentifizierung für Remote-Datenbanken

Konfiguration

Dieser Server ist für den Einsatz in einer MCP-Konfiguration konzipiert. Hier sind Beispiele für verschiedene Umgebungen:

Cline-Konfiguration

Fügen Sie dies zu Ihren Cline MCP-Einstellungen hinzu:

{
	"mcpServers": {
		"mcp-memory-libsql": {
			"command": "npx",
			"args": ["-y", "mcp-memory-libsql"],
			"env": {
				"LIBSQL_URL": "file:/path/to/your/database.db"
			}
		}
	}
}

Claude Desktop mit WSL-Konfiguration

Eine ausführliche Anleitung zum Einrichten dieses Servers mit Claude Desktop in WSL finden Sie unter Getting MCP Server Working with Claude Desktop in WSL .

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration für WSL-Umgebungen hinzu:

{
	"mcpServers": {
		"mcp-memory-libsql": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && LIBSQL_URL=file:/path/to/database.db /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-memory-libsql"
			]
		}
	}
}

Datenbankkonfiguration

Der Server unterstützt sowohl lokale SQLite- als auch Remote-libSQL-Datenbanken über die Umgebungsvariable LIBSQL_URL:

Für lokale SQLite-Datenbanken:

{
	"env": {
		"LIBSQL_URL": "file:/path/to/database.db"
	}
}

Für Remote-libSQL-Datenbanken (z. B. Turso):

{
	"env": {
		"LIBSQL_URL": "libsql://your-database.turso.io",
		"LIBSQL_AUTH_TOKEN": "your-auth-token"
	}
}

Hinweis: Achten Sie bei der Verwendung von WSL darauf, dass der Datenbankpfad das Linux-Dateisystemformat (z. B. /home/username/... ) und nicht das Windows-Format verwendet.

Wenn keine URL angegeben ist, wird standardmäßig file:/memory-tool.db im aktuellen Verzeichnis verwendet.

API

Der Server implementiert die Standard-MCP-Speicherschnittstelle mit zusätzlichen Vektorsuchfunktionen:

Entitätsverwaltung
- Entitäten mit Einbettungen erstellen/aktualisieren
- Entitäten löschen
- Suche nach Entitäten nach Ähnlichkeit
Beziehungsmanagement
- Erstellen von Beziehungen zwischen Entitäten
- Beziehungen löschen
- Abfragen verwandter Entitäten

Architektur

Der Server verwendet eine libSQL-Datenbank mit dem folgenden Schema:

Entitätentabelle: Speichert Entitätsinformationen und Einbettungen
Beziehungstabelle: Speichert Beziehungen zwischen Entitäten
Vektorsuchfunktionen, die mit den integrierten Vektoroperationen von libSQL implementiert wurden

Entwicklung

Veröffentlichen

Aufgrund der npm 2FA-Anforderungen muss die Veröffentlichung manuell erfolgen:

Erstellen Sie einen Änderungssatz (dokumentieren Sie Ihre Änderungen):

pnpm changeset

Version des Pakets (aktualisiert Version und Änderungsprotokoll):

pnpm changeset version

Auf npm veröffentlichen (fordert zur Eingabe des 2FA-Codes auf):

pnpm release

Beitragen

Beiträge sind willkommen! Bitte lesen Sie unsere Richtlinien für Beiträge, bevor Sie Pull Requests einreichen.

Lizenz

MIT-Lizenz – Einzelheiten finden Sie in der Datei LICENSE .

Danksagung

Basierend auf dem Model Context Protocol
Unterstützt durch libSQL

mcp-memory-libsql

Integrations