MySQL MCP Server: agent na bazie MySQL i MariaDB.

MCP-Server-MySQL to serwer Model Context Protocol, który umożliwia Claude Code dostęp do baz MySQL i MariaDB. Pozwala wykonywać zapytania SQL, podglądać i tworzyć tabele oraz zarządzać danymi — z poziomu naturalnego języka.

Wymagania

• Node.js w wersji 20 lub nowszej.
• Dostęp do bazy MySQL lub MariaDB (host, port, użytkownik, hasło, nazwa bazy).

# weryfikacja wersji Node.js
node --version

Instalacja serwera

Repo nie wymaga instalacji globalnej. Najprościej uruchamiać serwer przez npx — pobiera i odpala aktualną wersję bez dbania o ścieżki:

npx -y @benborla29/mcp-server-mysql

Konfiguracja środowiska (.env)

Utwórz plik .env z danymi połączenia i uprawnieniami:

# Polaczenie
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=twoj_uzytkownik
MYSQL_PASS=twoje_haslo
MYSQL_DB=nazwa_bazy

# Uprawnienia (domyslnie wszystkie wylaczone)
ALLOW_INSERT_OPERATION=true
ALLOW_UPDATE_OPERATION=true
ALLOW_DELETE_OPERATION=true
ALLOW_DDL_OPERATION=true

Konfiguracja Claude Desktop

Dodaj wpis serwera do pliku konfiguracyjnego Claude Desktop (klamry zakodowane encjami, w realnym pliku JSON użyj zwykłych nawiasów). Zamiast kruchych ścieżek absolutnych do node i dist/index.js uruchamiaj przez npx:

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "twoj_uzytkownik",
        "MYSQL_PASS": "twoje_haslo",
        "MYSQL_DB": "nazwa_bazy",
        "ALLOW_INSERT_OPERATION": "true",
        "ALLOW_UPDATE_OPERATION": "true",
        "ALLOW_DELETE_OPERATION": "true",
        "ALLOW_DDL_OPERATION": "true"
      }
    }
  }
}

Test i import do Claude Code

Zrestartuj Claude Desktop i sprawdź połączenie:

Pokaz mi wszystkie tabele MySQL z localhost za pomoca MCP

Po udanym teście zaimportuj serwer do Claude Code:

claude mcp add-from-claude-desktop

Możesz też dodać serwer wprost, jednym poleceniem — bez wcześniejszej konfiguracji Claude Desktop:

claude mcp add mcp_server_mysql -e MYSQL_HOST=127.0.0.1 -e MYSQL_PORT=3306 -e MYSQL_USER=root -e MYSQL_PASS=... -e MYSQL_DB=... -- npx @benborla29/mcp-server-mysql

Przykłady użycia

• „Załóż tabelę użytkowników z polami: id, email, created_at".
• „Pokaż strukturę tabeli products".
• „Znajdź wszystkich użytkowników z domeny gmail.com".
• „Zoptymalizuj wydajność zapytań na tabeli logs".
• „Przeanalizuj rozmiar bazy i zaproponuj archiwizację".