Akademia · MySQL MCP Server
MCP-Server-MySQL daje Claude Code bezpośredni dostęp do baz MySQL i MariaDB: zapytania SQL, podgląd struktury, tworzenie tabel i zarządzanie danymi. Operacje zapisu są domyślnie wyłączone — włączasz je świadomie, flaga po fladze.
Ostatnia aktualizacja:
01 / MCP · Czym jest i instalacja
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.
# weryfikacja wersji Node.js
node --version Serwera nie trzeba instalować osobno. Główna ścieżka to claude mcp add — rejestruje serwer w Claude Code, a npx pobiera i uruchamia go przy każdym starcie, bez dbania o ścieżki:
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 Po dodaniu sprawdź połączenie prosto w rozmowie z agentem:
Pokaz mi wszystkie tabele MySQL z localhost za pomoca MCP Zwróć uwagę: w poleceniu nie ma żadnej flagi uprawnień. To celowe — bez nich serwer działa w trybie tylko do odczytu: zapytania odczytają dane, ale niczego nie zmienią. Które flagi odblokowują zapis, kiedy warto je włączyć i jak wygląda pełna konfiguracja — w dalszej części szkolenia.
02 / Praktyka · Operacje i konfiguracja
Pro tip: w pliku CLAUDE.md możesz zapisać instrukcję, by agent korzystał z MCP MySQL dla wszystkich operacji na bazie — np. „Używaj MCP MySQL dla wszystkich operacji na bazie danych".
Najnowsze wydanie to v2.0.9 (czerwiec 2026). Zamiast pinować konkretną podwersję czy instalować globalnie przez npm install -g, uruchamiaj serwer przez npx — zawsze sięgnie po aktualne wydanie z npm i nie zostawi w systemie przestarzałej kopii. Unikaj też kruchych ścieżek absolutnych do node i dist/index.js w konfiguracji.
Gdy uruchamiasz serwer poza Claude Code albo wolisz trzymać ustawienia w pliku, utwórz .env z danymi połączenia i uprawnieniami. Bezpieczny domyślny wariant — tylko odczyt:
# Polaczenie
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=twoj_uzytkownik
MYSQL_PASS=twoje_haslo
MYSQL_DB=nazwa_bazy
# Uprawnienia — bezpieczny default: tylko odczyt
ALLOW_INSERT_OPERATION=false
ALLOW_UPDATE_OPERATION=false
ALLOW_DELETE_OPERATION=false
ALLOW_DDL_OPERATION=false Kiedy włączyć zapis: trzy flagi zapisu (INSERT, UPDATE, DELETE) przestaw na true dopiero wtedy, gdy agent ma faktycznie modyfikować dane — najlepiej na bazie deweloperskiej, nie produkcyjnej. Operacje DDL (CREATE, ALTER, DROP) to osobna, czwarta flaga — serwer blokuje je niezależnie od uprawnień użytkownika po stronie bazy, dopóki sam jej nie włączysz.
Jeśli pracujesz też w Claude Desktop, dodaj wpis serwera do jego pliku konfiguracyjnego (klamry zakodowane encjami, w realnym pliku JSON użyj zwykłych nawiasów):
{
"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": "false",
"ALLOW_UPDATE_OPERATION": "false",
"ALLOW_DELETE_OPERATION": "false",
"ALLOW_DDL_OPERATION": "false"
}
}
}
} Zrestartuj Claude Desktop, sprawdź połączenie tym samym promptem testowym co po instalacji, a potem zaimportuj gotowy wpis do Claude Code:
claude mcp add-from-claude-desktop 03 / Akademia · Czytaj dalej
Wdrożenie u Was
Akademia to materiały. Wdrożenie to dwa kwartały na Waszym kodzie — z pomiarem efektu w DEVLens. Audyt 90 minut wystarczy, żeby sprawdzić, czy ma to u Was sens.