MariaDB MCP Server

by bretoreta

Integrations

  • Provides access to MariaDB databases, allowing users to list databases, explore table schemas, and execute read-only SQL queries with security features like query validation and resource limits.

  • Enables interaction with MySQL databases through capabilities to list available databases, browse tables, describe table structures, and run SQL queries with built-in security controls.

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" } }

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 .

-
security - not tested
F
license - not found
-
quality - not tested

Bietet sicheren, schreibgeschützten Zugriff auf MariaDB/MySQL-Datenbanken und ermöglicht Benutzern, Datenbanken aufzulisten, Tabellenschemata zu erkunden und SQL-Abfragen mit integrierten Sicherheitsmaßnahmen auszuführen.

  1. Sicherheitsfunktionen
    1. Installation
      1. Option 1: Aus der Quelle erstellen
      2. 2. Umgebungsvariablen konfigurieren
      3. 3. Zu den MCP-Einstellungen hinzufügen
    2. Verfügbare Tools
      1. Datenbankliste
      2. list_tables
      3. Tabelle beschreiben
      4. Abfrage ausführen
    3. Testen
      1. Fehlerbehebung
        1. Lizenz

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            Enables interaction with a MySQL database via JSON commands, supporting read-only queries, test execution of write queries, and table information retrieval through Docker.
            Last updated -
            4
            5
            5
            JavaScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that provides read-only access to MySQL databases, enabling LLMs to inspect database schemas and execute read-only queries.
            Last updated -
            1,363
            350
            TypeScript
            MIT License
            • Linux
            • Apple
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that provides read-only access to MySQL databases, enabling LLMs to inspect database schemas and execute read-only queries.
            Last updated -
            1,363
            MIT License
          • -
            security
            A
            license
            -
            quality
            An MCP server implementation that enables Claude to execute read-only queries against MariaDB databases and explore database schemas through natural language.
            Last updated -
            5
            Python
            MIT License
            • Apple

          View all related MCP servers

          ID: 9tru29x6wk