Redis CRUD MCP-Server

Dies ist ein MCP-Server-Plugin (Model Context Protocol) für Redis-Datenbankoperationen, das vollständige CRUD-Tools bereitstellt.

✨ Funktionen

• 🔍 Automatische Erkennung der Projektkonfiguration - Sucht automatisch nach .env-Dateien, um das Projektstammverzeichnis zu finden

• 🔄 Unterstützung für mehrere Projekte - Verschiedene Projekte verwenden automatisch unterschiedliche Redis-Verbindungen

• ⏱️ Verbindungs-Timeout-Schutz - Standard-Timeout von 10 Sekunden, konfigurierbar über Umgebungsvariablen

• 📝 Mehrere Konfigurationsformate - Unterstützt sowohl INI-Sektionen als auch KEY=VALUE-Formate

• 🛠️ Kompatibilität mit mehreren Tools - Unterstützt Claude Code, Cline, Codex usw.

🚀 Schnellstart

Globale Installation (empfohlen)

npm install -g redis-crud-server

MCP-Konfiguration

Erstellen Sie eine .mcp.json im Projektstammverzeichnis:

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server"
    }
  }
}

⚙️ Konfigurationshinweise

Konfigurationsformat 1: INI-Sektionsformat

[REDIS]
REDIS_HOSTNAME = 127.0.0.1
PORT = 6379
REDIS_PASSWORD = your_password
SELECT = 0

Konfigurationsformat 2: KEY=VALUE-Format

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=your_password

Unterstützte Konfigurationsnamen

🔧 Tool-Liste

String-Operationen

• redis_set - Setzt einen String-Schlüsselwert

• redis_get - Ruft einen String-Schlüsselwert ab

• redis_del - Löscht einen Schlüssel

• redis_exists - Überprüft, ob ein Schlüssel existiert

Hash-Operationen

• redis_hset - Setzt ein Hash-Feld

• redis_hget - Ruft ein Hash-Feld ab

• redis_hgetall - Ruft alle Hash-Felder ab

• redis_hdel - Löscht ein Hash-Feld

Informationen

• redis_info - Ruft Verbindungsinformationen ab

⏱️ Timeout-Konfiguration

Das Standard-Verbindungs-Timeout beträgt 10 Sekunden und kann über Umgebungsvariablen konfiguriert werden:

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server",
      "env": {
        "REDIS_TIMEOUT": "30000"
      }
    }
  }
}

📝 Anwendungsbeispiele

Schlüsselwert setzen

redis_set: key=test_key, value=hello_world

Schlüsselwert abrufen

redis_get: key=test_key

Hash-Operationen

redis_hset: key=user:1, field=name, value=张三
redis_hget: key=user:1, field=name
redis_hgetall: key=user:1

🐛 Fehlerbehebung

Verbindungs-Timeout

• Überprüfen Sie die Netzwerkverbindung und die Firewall-Einstellungen

• Bestätigen Sie, dass der Redis-Server erreichbar ist

• Passen Sie die Umgebungsvariable REDIS_TIMEOUT an

Konfigurationsdatei nicht gefunden

• Stellen Sie sicher, dass sich die .env-Datei im Projektstammverzeichnis befindet

• MCP sucht automatisch im Verzeichnisbaum nach oben nach der .env-Datei

INI-Format-Analyse fehlgeschlagen

• Stellen Sie sicher, dass der korrekte Sektionsname [REDIS] verwendet wird

• Unterstützt Windows (\r\n), Unix (\n) und alte Mac (\r) Zeilenumbrüche

📄 Lizenz

MIT