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

Related MCP server: MySQL MCP Server

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:

1. Überprüfen Sie die Serverprotokolle auf Fehlermeldungen

2. Überprüfen Sie Ihre MariaDB-Anmeldeinformationen und Verbindungsdetails

3. Stellen Sie sicher, dass Ihr MariaDB-Benutzer über die entsprechenden Berechtigungen verfügt

4. Überprüfen Sie, ob Ihre Abfrage schreibgeschützt und richtig formatiert ist

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

Lizenz

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• describe_tableB
• execute_queryC
• list_databasesB
• list_tablesC