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

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 .

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

Forken Sie das Repository
Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature )
Übernehmen Sie Ihre Änderungen ( git commit -m 'Add some amazing feature' )
Pushen zum Zweig ( git push origin feature/amazing-feature )
Öffnen einer Pull-Anfrage

Lizenz

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

MySQL Navigator MCP

Integrations