MySQL MCP

![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg

MySQL MCP verbindet eine AI-Anwendung mit einer einzelnen MySQL- oder MariaDB-Datenbank: Struktur ansehen, Daten in natürlicher Sprache abfragen, langsame Abfragen analysieren – und, wenn Sie es selbst erlaubt haben, Daten ändern.

Der Server ist an eine einzelne Datenbank gebunden: Sie wird über die Konfiguration festgelegt, und kein Tool kann auf eine andere zugreifen. Standardmäßig ist nur Lesen möglich.

• 6 Tools. Verbindung und Berechtigungen, Tabellenliste, Tabellenstruktur, Leseabfrage, Abfrageplan, Schreibabfrage.

• Der Server bestimmt den Abfragetyp. SQL wird vor der Verbindung geparst: DELETE in einem Lesetool wird abgelehnt, selbst wenn Schreibrechte aktiviert sind.

• Lesen kann nicht schreiben. Leseabfragen laufen in einer START TRANSACTION READ ONLY-Transaktion – Schreibversuche lehnt MySQL selbst ab, selbst wenn jemand das SQL-Parsing austrickst.

• Die Antwort überlastet den Kontext nicht. Zeilen werden gestreamt und an der Grenze abgeschnitten, statt vollständig geladen zu werden; die Antwort enthält ein ehrliches truncated-Flag.

• Rechte nur von außen. INSERT, UPDATE und DELETE werden über Umgebungsvariablen aktiviert und erfordern einen Neustart – aus dem Dialog heraus sind sie nicht erhältlich. DDL ist immer deaktiviert.

Beginnen Sie mit einer Abfrage, die nur Daten liest:

Zeig mir die Datenbankstruktur und zähle, wie viele Datensätze in der letzten Woche hinzugekommen sind.

Schnellstart

Claude Code:

claude mcp add mysql-myapp \
  -e MYSQL_HOST=db.example.com \
  -e MYSQL_USER=myapp_ro \
  -e MYSQL_PASS='пароль' \
  -e MYSQL_DB=myapp \
  -e MYSQL_SSL=true \
  -- npx -y mcp-mysql-client

Oder in .mcp.json / claude_desktop_config.json:

{
  "mcpServers": {
    "mysql-myapp": {
      "command": "npx",
      "args": ["-y", "mcp-mysql-client"],
      "env": {
        "MYSQL_HOST": "db.example.com",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "myapp_ro",
        "MYSQL_PASS": "пароль",
        "MYSQL_DB": "myapp",
        "MYSQL_SSL": "true"
      }
    }
  }
}

Ein Server – eine Datenbank. Sie benötigen mehrere Datenbanken: Fügen Sie mehrere Einträge mit eigenen Anmeldedaten hinzu; so bleiben die Rechte isoliert und der mit der Testdatenbank verbundene Server sieht die Produktionsdatenbank physisch nicht.

Related MCP server: MySQL MCP Server

Was Sie erledigen lassen können

Was geändert werden kann

Standardmäßig nichts: Der Server startet im Nur-Lese-Modus. Das Schreiben wird pro Operation aktiviert:

"ALLOW_INSERT_OPERATION": "true",
"ALLOW_UPDATE_OPERATION": "true",
"ALLOW_DELETE_OPERATION": "false"

Was dabei weiterhin unmöglich bleibt:

• DDL – CREATE, ALTER, DROP, TRUNCATE, RENAME – unter keinen Umständen.

• Datenbankwechsel, SET, CALL, PREPARE, LOAD DATA, Sperren, GRANT und anderes, das die Bedeutung der nächsten Abfrage ändert oder ungeprüften Text ausführt.

• SELECT ... INTO OUTFILE – Schreiben einer Datei auf den Datenbankserver.

• UPDATE und DELETE ohne WHERE – erfordern eine explizite Bestätigung allow_full_table=true im Aufruf.

• Mehrere Anweisungen in einem Aufruf – es wird genau eine ausgeführt.

MySQL-Berechtigungen sind eine zusätzliche Einschränkung darüber hinaus. Die Berechtigung ALLOW_UPDATE_OPERATION fügt einem Benutzer ohne GRANT UPDATE nichts hinzu. Bewährte Praxis: ein separater Benutzer mit minimalen Rechten statt root.

Umgebungsvariablen

Das Passwort liegt in der MCP-Client-Konfiguration im Klartext vor. MYSQL_PASS_FILE ermöglicht es, es in einer Datei mit den entsprechenden Berechtigungen aufzubewahren.

Migration von @benbor29la/mcp-server-mysql

Die Variablennamen stimmen überein, daher reicht es, das Paket im Startbefehl zu ersetzen:

-  "args": ["-y", "@benborla29/mcp-server-mysql"]
+  "args": ["-y", "mcp-mysql-client"]

Was sich im Verhalten ändert:

• MYSQL_DB ist erforderlich – der Server ist immer an eine Datenbank gebunden;

• Antworten sind auf MYSQL_MAX_ROWS begrenzt und werden mit truncated markiert;

• DDL ist selbst bei aktivierten Schreibrechten nicht verfügbar;

• UPDATE/DELETE ohne WHERE erfordern eine Bestätigung im Aufruf;

• Der Tool-Satz ist anders: query, execute, explain, list_tables, describe_table, server_info.

Diagnose

Zunächst einmal server_info: Es zeigt, womit der Server verbunden ist, welche Rechte der MySQL-Benutzer hat und welche Einschränkungen aktiv sind.

Technische Dokumentation

• Tools – Parameter und Antworten

• Entwicklung – Build, Tests, Live-Prüfung

• Veröffentlichung – Release in npm und MCP-Registry

• CLAUDE.md – Repository-Aufbau für KI-Agenten

Lizenz

MIT