Narzędzia serwera usługi Azure MCP dla usługi Azure Database for MySQL

Narzędzia serwera MCP platformy Azure ułatwiają zarządzanie serwerami, bazami danych, ustawieniami konfiguracji i schematami usługi Azure Database for MySQL. Za pomocą narzędzi można pobierać i wyświetlać listę serwerów i baz danych, wykonywać zapytania dotyczące schematów tabel i danych oraz ustawiać parametry serwera przy użyciu monitów języka naturalnego.

Azure Database for MySQL to zarządzana usługa relacyjnej bazy danych oparta na wersji Community Edition mySQL. Aby uzyskać więcej informacji, zobacz dokumentację usługi Azure Database for MySQL.

Uwaga / Notatka

Parametry narzędzia: narzędzia serwera MCP platformy Azure definiują parametry potrzebne do przetwarzania danych niezbędnych do realizacji zadań. Niektóre z tych parametrów są specyficzne dla każdego narzędzia i zostały opisane tutaj. Inne parametry są globalne i współużytkowane przez wszystkie narzędzia. Aby uzyskać więcej informacji, zobacz Parametry narzędzia.

Pobieranie baz danych serwerów MySQL

Wyświetl listę serwerów, baz danych lub tabel usługi Azure Database for MySQL w ramach subskrypcji. Domyślnie to narzędzie zwraca wszystkie serwery w subskrypcji. resource-group Określ parametr, który ma zwracać serwery w grupie zasobów. Określ parametr do wyświetlania server listy baz danych na serwerze lub określ parametry server i database do wyświetlania listy tabel w bazie danych.

Przykładowe monity obejmują:

  • "Wyświetl listę wszystkich serwerów MySQL w mojej subskrypcji".
  • "Pokaż mi serwery MySQL w grupie zasobów "web-rg".
  • "Jakie serwery MySQL znajdują się w grupie zasobów 'rg-staging'?"
  • "Wyświetl listę wszystkich baz danych MySQL na serwerze "mysql-server-01" w grupie zasobów "rg-prod" przy użyciu nazwy użytkownika "dbadmin".
  • "Pokaż mi bazy danych MySQL na serwerze "mysql-dbserver" dla grupy zasobów "rg-dev" z nazwą użytkownika "mysqluser".
  • "Wyświetl listę wszystkich tabel w bazie danych MySQL "salesdb" na serwerze "mysql-server-01" w grupie zasobów "rg-prod" przy użyciu nazwy użytkownika "dbadmin".
  • "Pokaż tabele w bazie danych "inventory" na serwerze "mysql-dbserver" dla grupy zasobów "rg-test" z nazwą użytkownika "mysqluser".
Parameter Wymagane lub opcjonalne Description
Grupa zasobów Opcjonalna Nazwa grupy zasobów platformy Azure, która zawiera zasoby. Pomiń ten parametr, aby wyświetlić listę wszystkich serwerów w subskrypcji.
Nazwa użytkownika Opcjonalna Nazwa użytkownika, aby uzyskać dostęp do serwera usługi Azure Database for MySQL. Wymagane podczas określania parametru Nazwa serwera do wyświetlania listy baz danych lub tabel.
Nazwa bazy danych Opcjonalna Nazwa bazy danych Azure Database for MySQL, z której ma zostać wyświetlona lista tabel. Wymaga parametru Nazwa serwera .
Nazwa serwera Opcjonalna Nazwa serwera usługi Azure Database for MySQL do wyświetlenia listy baz danych.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Wykonywanie zapytań względem bazy danych MySQL

Narzędzie Model Context Protocol (MCP) uruchamia bezpieczne zapytanie SQL SELECT tylko do odczytu względem bazy danych elastycznego serwera Azure Database for MySQL. Użyj tego narzędzia, aby pobrać lub sprawdzić dane tabeli bez ich modyfikowania. Narzędzie odrzuca instrukcje inne niż SELECT, takie jak INSERT, UPDATE, DELETE, REPLACE, MERGE, TRUNCATE, ALTER, CREATE i DROP. Odrzuca również złożone instrukcje, komentarze skrywające zapisy, kontrolę transakcji (BEGIN/COMMIT/ROLLBACK), INTO OUTFILE, i inne szkodliwe słowa kluczowe. To narzędzie wykonuje tylko jedną SELECT instrukcję, aby zapewnić integralność danych.

Aby uzyskać najlepsze wyniki, wyświetl potrzebne kolumny zamiast używać elementu SELECT *. Dodaj WHERE filtry, użyj LIMIT/OFFSET do stronicowania, a ORDER BY dodaj do uzyskania deterministycznych wyników. Unikaj zwracania niepotrzebnych poufnych danych.

Przykładowe monity obejmują:

  • Wykonaj zapytanie 'SELECT id, name, email FROM customers WHERE id > 100 ORDER BY name LIMIT 50' w bazie danych 'ecommerce_db' w grupie zasobów 'rg-prod' na serwerze 'mysql-prod-server' jako użytkownik 'readonlyuser'.
Parameter Wymagane lub opcjonalne Description
Nazwa bazy danych Wymagane Baza danych MySQL, do której należy uzyskać dostęp.
Zapytanie Wymagane Wykonywanie zapytania względem bazy danych MySQL.
Grupa zasobów Wymagane Nazwa grupy zasobów platformy Azure. Ta grupa zasobów jest kontenerem logicznym dla zasobów platformy Azure.
Nazwa serwera Wymagane Serwer MySQL, do którego uzyskuje się dostęp.
Nazwa użytkownika Wymagane Nazwa użytkownika służąca do uzyskiwania dostępu do serwera MySQL.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Pobieranie konfiguracji serwera

To narzędzie jest częścią narzędzi protokołu MCP (Model Context Protocol). Pobiera szczegółowe szczegóły konfiguracji dla określonej instancji Azure Database for MySQL Flexible Server. Narzędzie zwraca ustawienia serwera, parametry wydajności, konfiguracje zabezpieczeń i cechy operacyjne, które ułatwiają zarządzanie bazą danych i optymalizowanie jej. Dane wyjściowe to JSON i zawiera wartości ServerName, Location, Version, SKU, StorageSizeGB, BackupRetentionDays i GeoRedundantBackup.

Przykładowe monity obejmują:

  • "Pokaż konfigurację serwera MySQL "mysql-prod" w grupie zasobów "rg-prod" za pomocą użytkownika "dbadmin".
Parameter Wymagane lub opcjonalne Description
Grupa zasobów Wymagane Nazwa grupy zasobów platformy Azure, która zawiera serwer.
Nazwa serwera Wymagane Nazwa instancji elastycznego serwera usługi Azure Database for MySQL.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Pobieranie parametru serwera

To narzędzie protokołu MCP (Model Context Protocol) pobiera bieżącą wartość parametru konfiguracji pojedynczego serwera na serwerze elastycznym usługi Azure Database for MySQL. Użyj tego narzędzia, aby sprawdzić ustawienie, takie jak max_connections, wait_timeoutlub slow_query_log, przed jego zmianą. To narzędzie wymaga konta użytkownika z wystarczającymi uprawnieniami do odczytu parametrów serwera.

Przykładowe monity obejmują:

  • "Pokaż mi wartość parametru "connection_timeout" w grupie zasobów "rg-prod" dla serwera MySQL "my-mysql-server" z nazwą użytkownika "dbadmin".
Parameter Wymagane lub opcjonalne Description
Parameter Wymagane Parametr MySQL umożliwiający dostęp.
Grupa zasobów Wymagane Nazwa grupy zasobów platformy Azure. Ta grupa zasobów jest kontenerem logicznym dla zasobów platformy Azure.
Nazwa serwera Wymagane Serwer MySQL, do którego uzyskuje się dostęp.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Aktualizowanie parametru serwera

To narzędzie, część protokołu MCP (Model Context Protocol), aktualizuje jedno ustawienie konfiguracji na serwerze usługi Azure Database for MySQL. Należy określić grupę zasobów, nazwę serwera, nazwę użytkownika i wartość do ustawienia.

Przykładowe monity obejmują:

  • "Ustaw parametr "connection_timeout" na wartość "20" w nazwie serwera "mysql-prod" w grupie zasobów "rg-prod" z nazwą użytkownika "dbadmin".
Parameter Wymagane lub opcjonalne Description
Parameter Wymagane Parametr MySQL umożliwiający dostęp.
Grupa zasobów Wymagane Nazwa grupy zasobów platformy Azure. Ta grupa zasobów jest kontenerem logicznym dla zasobów platformy Azure.
Nazwa serwera Wymagane Serwer MySQL, do którego uzyskuje się dostęp.
Wartość Wymagane Wartość ustawiona dla parametru MySQL.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
✅ ✅ ❌ ❌ ❌ ❌

Examples

  • Ustaw autocommit wartość "ON" dla serwera "my-mysql-server" w grupie zasobów "prod-rg" przy użyciu użytkownika "dbadmin".
  • Ustaw slow_query_log na "ON" dla serwera "analytics-db" w grupie zasobów "analytics-rg" za pomocą użytkownika "monitor".
  • Ustaw max_connections wartość "200" dla serwera "web-db-server" w grupie zasobów "web-rg" przy użyciu użytkownika "dbadmin".

Pobieranie schematu tabeli

To narzędzie protokołu MCP (Model Context Protocol) pobiera szczegółowe informacje o schemacie dla określonej tabeli w wystąpieniu serwera elastycznego usługi Azure Database for MySQL. Zwraca kompleksowe metadane, w tym definicje kolumn, typy danych, ograniczenia, indeksy i relacje. Te metadane pomagają zrozumieć strukturę tabel i obsługiwać tworzenie aplikacji.

Przykładowe monity obejmują:

  • Pokaż strukturę tabeli „orders” w bazie danych „salesdb” na serwerze „mysql-prod” w grupie zasobów „rg-db-prod” jako użytkownik „dbadmin”.
Parameter Wymagane lub opcjonalne Description
Nazwa bazy danych Wymagane Baza danych MySQL, do której należy uzyskać dostęp.
Grupa zasobów Wymagane Nazwa grupy zasobów platformy Azure, która zawiera serwer.
Nazwa serwera Wymagane Serwer MySQL hostujący bazę danych.
Nazwa tabeli Wymagane Tabela, dla której pobierane są informacje o schemacie.
Nazwa użytkownika Wymagane Nazwa użytkownika do uwierzytelniania na serwerze MySQL.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌