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:
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 --versionSerwera 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-mysqlPo dodaniu sprawdź połączenie prosto w rozmowie z agentem:
Pokaz mi wszystkie tabele MySQL z localhost za pomoca MCPZwróć 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.
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=falseKiedy 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.
Aktualizacja: wydanie 2.0.9 pozwala ustawić uprawnienia osobno dla każdej bazy. Zmienne SCHEMA_INSERT_PERMISSIONS, SCHEMA_UPDATE_PERMISSIONS, SCHEMA_DELETE_PERMISSIONS i SCHEMA_DDL_PERMISSIONS przyjmują listę w rodzaju development:true,production:false i nadpisują flagi globalne. Produkcja zostaje tylko do odczytu, a agent zapisuje na bazie deweloperskiej. Gdy w wynikach mogą się pojawić dane osobowe, dodaj ENABLE_PII_REDACTION=true: serwer zamaskuje adresy e-mail, numery telefonów czy kart, zanim wynik zapytania trafi do modelu.
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-desktopAkademia 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.