MariaDB / MySQL-Datenbankzugriff MCP-Server

Dieser MCP-Server bietet Zugriff auf MariaDB-/MySQL-Datenbanken.

Es ermöglicht Ihnen:

Verfügbare Datenbanken auflisten
Auflisten von Tabellen in einer Datenbank
Beschreiben von Tabellenschemata
Ausführen von SQL-Abfragen

Sicherheitsfunktionen

Nur-Lese-Zugriff Standard : SELECT, SHOW, DESCRIBE und EXPLAIN
Abfragevalidierung : Verhindert SQL-Injection und blockiert alle Versuche zur Datenänderung
Abfrage-Timeout : Verhindert, dass Abfragen mit langer Laufzeit Ressourcen verbrauchen
Zeilenbegrenzung : Verhindert übermäßige Datenrückgabe

Installation

Option 1: Aus der Quelle erstellen

# Clone the repository git clone https://github.com/bretoreta/mariadb-mcp-server.git cd mariadb-mcp-server # Install dependencies and build pnpm install pnpm run build

2. Umgebungsvariablen konfigurieren

Der Server benötigt die folgenden Umgebungsvariablen:

MARIADB_HOST: Hostname des Datenbankservers
MARIADB_PORT: Datenbankserver-Port (Standard: 3306)
MARIADB_USER: Datenbankbenutzername
MARIADB_PASSWORD: Datenbankkennwort
MARIADB_DATABASE: Standarddatenbankname (optional)
MARIADB_ALLOW_INSERT: falsch
MARIADB_ALLOW_UPDATE: falsch
MARIADB_ALLOW_DELETE: falsch
MARIADB_TIMEOUT_MS: 10000
MARIADB_ROW_LIMIT: 1000

3. Zu den MCP-Einstellungen hinzufügen

Fügen Sie Ihrer MCP-Einstellungsdatei die folgende Konfiguration hinzu:

Wenn Sie aus der Quelle erstellt haben:

{ "mcpServers": { "mariadb": { "command": "node", "args": ["/path/to/mariadb-mcp-server/dist/index.js"], "env": { "MARIADB_HOST": "your-host", "MARIADB_PORT": "3306", "MARIADB_USER": "your-user", "MARIADB_PASSWORD": "your-password", "MARIADB_DATABASE": "your-default-database", "MARIADB_ALLOW_INSERT": "false", "MARIADB_ALLOW_UPDATE": "false", "MARIADB_ALLOW_DELETE": "false", "MARIADB_TIMEOUT_MS": "10000", "MARIADB_ROW_LIMIT": "1000", }, "disabled": false, "autoApprove": [] } } }

Verfügbare Tools

Datenbankliste

Listet alle erreichbaren Datenbanken auf dem MariaDB/MySQL-Server auf. Parameter : Keine

Beispiel :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "list_databases" } }

list_tables

Listet alle Tabellen in einer angegebenen Datenbank auf.

Parameter :

database (optional): Datenbankname (verwendet den Standard, wenn nicht angegeben)

Beispiel :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "list_tables", "database": "my_database_name" } }

Tabelle beschreiben

Zeigt das Schema für eine bestimmte Tabelle.

Parameter :

database (optional): Datenbankname (verwendet den Standard, wenn nicht angegeben)
table (erforderlich): Tabellenname

Beispiel :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "describe_table", "database": "my_database_name", "table": "my_table_name" } }

Abfrage ausführen

Führt eine SQL-Abfrage aus.

Parameter :

query (erforderlich): SQL-Abfrage
database (optional): Datenbankname (verwendet den Standard, wenn nicht angegeben)

Beispiel :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "execute_query", "query": "SELECT * FROM my_table LIMIT 10" } }

Testen

Der Server testet MariaDB automatisch, um die Funktionalität mit Ihrem MariaDB-Setup zu überprüfen:

Fehlerbehebung

Wenn Probleme auftreten:

Überprüfen Sie die Serverprotokolle auf Fehlermeldungen
Überprüfen Sie Ihre MariaDB-Anmeldeinformationen und Verbindungsdetails
Stellen Sie sicher, dass Ihr MariaDB-Benutzer über die entsprechenden Berechtigungen verfügt
Überprüfen Sie, ob Ihre Abfrage schreibgeschützt und richtig formatiert ist

Inspiration https://github.com/rjsalgado/mariadb-mcp-server