Skip to main content
Glama

MySQL Navigator MCP

by Medsaad
MIT License
6
  • Linux
  • Apple

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 .
  1. 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.

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Medsaad/mcp-db-navigator'

If you have feedback or need assistance with the MCP directory API, please join our Discord server