MySQL Navigator MCP

Ein leistungsstarkes MySQL/MariaDB-Datenbanknavigationstool mit MCP (Model Control Protocol) für einfache Datenbankabfragen und -verwaltung.

Merkmale

• Verbindung zu MySQL/MariaDB-Datenbanken herstellen

• Dynamisches Wechseln zwischen verschiedenen Datenbanken

• Ausführen von SQL-Abfragen mit Typsicherheit

• Abrufen von Datenbankschemainformationen

• Pydantic-Modellvalidierung für Abfrageparameter

• Sichere Verwaltung von Anmeldeinformationen

• Umfassendes Protokollierungssystem

• Verbindungspooling und Wiederholungsmechanismen

• SSL/TLS-Unterstützung für sichere Verbindungen

Related MCP server: Maya MCP

Speicherort der Protokolldatei (plattformübergreifend)

Standardmäßig werden alle Protokolle in folgendes Verzeichnis geschrieben:

• Windows: C:\Users\<YourUsername>\.mcp\mcp-db.log

• macOS/Linux: /home/<yourusername>/.mcp/mcp-db.log oder /Users/<yourusername>/.mcp/mcp-db.log

Falls der Ordner .mcp in Ihrem Home-Verzeichnis nicht vorhanden ist, wird er automatisch erstellt. Bei Problemen können Sie den Ordner manuell erstellen:

Windows:

mkdir $env:USERPROFILE\.mcp

macOS/Linux:

mkdir -p ~/.mcp

Installation

Von PyPI (für die meisten Benutzer empfohlen):

pip install mcp-db-navigator

Aus der Quelle (für die Entwicklung):

git clone <your-repo-url>
cd mcp-db
pip install -e .

3. Erstellen Sie eine .env Datei mit Ihren Datenbankanmeldeinformationen:

DB_HOST=your_host
DB_PORT=your_port
DB_NAME=your_database_name
DB_USER=your_username
DB_PASSWORD=your_password
DB_SSL_CA=/path/to/ssl/ca.pem  # Optional: for SSL/TLS connections
DB_MAX_RETRIES=3  # Optional: number of connection retries
DB_RETRY_DELAY=1.0  # Optional: delay between retries in seconds

Anwendungsbeispiele

1. Befehlszeile

Führen Sie den MCP-Server direkt von Ihrem Terminal aus:

mcp-db --config /path/to/your/project/.env

2. Im Cursor

So verwenden Sie diesen MCP-Server in Cursor :

• Öffnen Sie die Cursor-Einstellungen und fügen Sie einen neuen MCP-Server hinzu.

• Verwenden Sie die folgende Konfiguration (Beispiel):

{
  "mcpServers": {
    "mysql-navigator": {
      "command": "mcp-db",
      "args": [
        "--config",
        "/absolute/path/to/your/.env"
      ]
    }
  }
}

• Stellen Sie sicher, dass der Pfad zu Ihrer .env Datei absolut ist.

3. In Claude Desktop

Wenn Claude Desktop MCP-Server unterstützt:

• Fügen Sie einen neuen MCP-Server hinzu und richten Sie ihn wie oben mit dem Argument --config auf den Befehl mcp-db .

• Einzelheiten zum Hinzufügen benutzerdefinierter MCP-Server finden Sie in der Dokumentation von Claude Desktop.

Abfrageparameter

Das Abfragewörterbuch unterstützt die folgenden Parameter:

• table_name (erforderlich): Name der abzufragenden Tabelle

• select_fields (optional): Liste der auszuwählenden Felder (Standardwert: ["*"])

• where_conditions (optional): Wörterbuch der Feld-Wert-Paare für die WHERE-Klausel

• order_by (optional): Liste der Felder, nach denen sortiert werden soll

• order_direction (optional): Sortierrichtung "ASC" oder "DESC" (Standard: "ASC")

• limit (optional): Anzahl der zurückzugebenden Datensätze

• offset (optional): Anzahl der zu überspringenden Datensätze

• group_by (optional): Liste der Felder, nach denen gruppiert werden soll

• having (optional): Wörterbuch der Feld-Wert-Paare für die HAVING-Klausel

• join_table (optional): Name der Tabelle, mit der eine Verbindung hergestellt werden soll

• join_type (optional): Typ der JOIN-Operation (Standard: „INNER“)

• join_conditions (optional): Wörterbuch der Join-Bedingungen

Sicherheitsfunktionen

• Datenbankanmeldeinformationen werden über eine Konfigurationsdatei verwaltet

• Passwörter werden in Pydantic-Modellen als SecretStr gespeichert

• Eingabevalidierung für alle Abfrageparameter

• SQL-Injection-Prävention durch parametrisierte Abfragen

• SSL/TLS-Unterstützung für verschlüsselte Verbindungen

• Bereinigung der Verbindungszeichenfolge

• Ratenbegrenzung für Abfragen

• Bereinigung von Abfrageparametern

Produktionsmerkmale

Fehlerbehandlung

• Umfassende Fehlerbehandlung für Datenbankoperationen

• Handhabung von Verbindungstimeouts

• Automatischer Wiederholungsmechanismus für fehlgeschlagene Verbindungen

• Eingabevalidierung für alle Parameter

Leistung

• Verbindungspooling für optimale Ressourcennutzung

• Protokollierung der Abfrageausführungszeit

• Verbindungspoolstatistiken

• Erfassung von Leistungsmetriken

Überwachung

• Strukturiertes Logging mit unterschiedlichen Log-Levels

• Abfrageausführungsverfolgung

• Überwachung des Verbindungsstatus

• Fehlerratenverfolgung

Beitragen

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature )

3. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add some amazing feature' )

4. Pushen zum Zweig ( git push origin feature/amazing-feature )

5. Öffnen einer Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.