MySQL MCP Server

MySQL MCP-Server

Der MySQL Model Context Protocol (MCP)-Server ist ein Tool, mit dem Sie eine Verbindung zu einer lokalen MySQL-Datenbank herstellen und großen Sprachmodellen (LLMs) erlauben können, SQL-Abfragen darauf auszuführen.

Anforderungen

• Node.js : 20.0.0 oder höher
• MySQL : MySQL- oder MariaDB-Serverversion 5.7 oder höher

Funktion

• MySQL-Abfragen ausführen : Führen Sie SQL-Abfragen direkt von LLM aus aus
• Datenbankinformationen abrufen : Liste der Datenbanken, Liste der Tabellen, Tabellenstruktur bestätigen
• MCP-kompatibel : Unterstützt Model Context Protocol und kann in LLM integriert werden
• stdio-Kommunikation : Kommunikation mit LLM über Standard-Ein-/Ausgabe, keine Portbindung
• Verbindungsprofilverwaltung : Verwalten und wechseln Sie zwischen mehreren Verbindungseinstellungen nach Profilnamen
• Verbindungsinformationen speichern : Datenbankverbindungsinformationen lokal speichern und wiederverwenden

Installation und Verwendung

Vorübergehende Ausführung in NPX

Option

Verbindungsinformationen speichern und wiederverwenden

MySQL MCP Server speichert Informationen über erfolgreich verbundene Datenbanken lokal als benannte Profile. Dadurch können Sie die Verbindungsinformationen bei nachfolgenden Aufrufen anhand des Namens wiederverwenden. Gespeicherte Verbindungsinformationen werden in .mysql-mcp-connections.json im Home-Verzeichnis des Benutzers gespeichert.

Jedes Verbindungsprofil umfasst:

• Profilname
• Hostname
• Portnummer
• Benutzername
• Passwort
• Datenbankname (falls festgelegt)

Sie können mehrere Datenbankverbindungen nach Profilnamen verwalten und einfach zwischen ihnen wechseln.

Verwenden von Konfigurationsdateien

Sie können die Verbindungsinformationen auch mithilfe einer Konfigurationsdatei (im JSON-Format) konfigurieren:

Wenn Sie eine Konfigurationsdatei verwenden:

Kommunikationsmethode

Der MySQL MCP-Server arbeitet im „stdio“-Modus gemäß MCP (Model Context Protocol). Dadurch kann über die Standardeingabe und -ausgabe kommuniziert werden, anstatt an einen bestimmten Port gebunden zu sein. Dies hat folgende Vorteile:

1. Vermeiden Sie Portkonflikte : Es werden keine bestimmten Ports verwendet, daher treten keine Portkonflikte auf
2. Verbesserte Sicherheit : Es wird keine Netzwerkkommunikation verwendet, wodurch das Risiko von Angriffen auf Netzwerkebene verringert wird
3. Einfache Interprozesskommunikation : Vereinfachte Kommunikation mit LLM

Wichtige Hinweise

• Im Standardmodus werden Nachrichten im JSON-Format gesendet.
• Sie müssen eine JSON-Nachricht pro Zeile senden
• Fehlerinformationen und Verbindungsprotokolle werden an den Standardfehler (stderr) ausgegeben.

Bereitgestellte MCP-Tools

Datenbankverbindungsverwaltung

Verbindungsprofilverwaltung

SQL-Abfrageoperationen

Verbindungsverwaltungsfunktion

Mit MySQL MCP Server können Sie Serverstart und Datenbankverbindungen trennen. Dieser Ansatz bietet die folgenden Vorteile:

1. Starten ohne Verbindungsinformationen : Der Server kann ohne Datenbankverbindungsinformationen gestartet werden.
2. Mehrere Datenbankverbindungen : Sie können nach dem Start des Servers zwischen Verbindungen zu verschiedenen Datenbanken wechseln.
3. Einfache Installation : Führen Sie einfach npx -y https://github.com/yuki777/mysql-mcp-server aus

So verwenden Sie die Verbindungsverwaltung

1. Starten Sie den Server ohne automatische Verbindung :
   npx -y https://github.com/yuki777/mysql-mcp-server
2. Stellen Sie mithilfe des Verbindungstools eine Verbindung zur Datenbank her (geben Sie einen Profilnamen an und speichern Sie ihn) :
   { "type": "tool_call", "request_id": "req_1", "tool": "connect_database", "arguments": { "host": "localhost", "port": 3306, "user": "root", "password": "your_password", "database": "your_db", "profileName": "my-db" } }
3. Holen Sie sich eine Liste der Profile :
   { "type": "tool_call", "request_id": "req_2", "tool": "list_profiles", "arguments": {} }
4. Über den Profilnamen verbinden :
   { "type": "tool_call", "request_id": "req_3", "tool": "connect_by_profile", "arguments": { "profileName": "my-db" } }
5. Ein neues Profil hinzufügen (ohne Verbindung) :
   { "type": "tool_call", "request_id": "req_4", "tool": "add_profile", "arguments": { "profileName": "production-db", "host": "prod.example.com", "port": 3306, "user": "prod_user", "password": "prod_password", "database": "production" } }
6. Überprüfen Sie Ihren Verbindungsstatus :
   { "type": "tool_call", "request_id": "req_5", "tool": "get_connection_status", "arguments": {} }
7. Verbindungsverlust :
   { "type": "tool_call", "request_id": "req_6", "tool": "disconnect_database", "arguments": {} }

Testskript

Das Repository enthält ein Testskript namens test-connection-management.js . Mit diesem Skript können Sie die Verbindungsverwaltungsfunktion testen:

Entwicklerinformationen

Einrichten Ihrer Entwicklungsumgebung

Bauen

Lizenz

ISC

Beitrag

Fehlerberichte, Funktionsanfragen und Pull-Anfragen sind willkommen.