Szybki start: Utwórz hostowany serwer MCP w przestrzeni nazw Connector (wersja zapoznawcza)

Wdrażanie przy użyciu interfejsu wiersza polecenia dla deweloperów platformy Azure

Najprostszym sposobem wdrożenia serwera SQL MCP jest przejście do przykładu azure-sql-mcp i postępowanie zgodnie z instrukcjami README, aby wdrożyć za pomocą Azure Developer CLI lub azd. Przykład zawiera pliki Bicep, które umożliwiają wdrożenie przestrzeni nazw Connector, serwera SQL MCP, bazy danych SQL oraz innych wymaganych zasobów platformy Azure jednym poleceniem.

Jeśli wolisz stopniowo wdrażać serwer SQL MCP i wymagane zasoby od początku do końca, postępuj zgodnie z poniższymi instrukcjami.

• Serwer Azure SQL Database z bazą danych. Jeśli go nie masz, utwórz bazę danych Azure SQL.

• Zainstalowano interfejs wiersza polecenia narzędzia Data API Builder (DAB).

Inicjowanie bazy danych SQL

1. W portalu Azure przejdź do bazy danych SQL (nie do serwera).

2. W menu po lewej stronie wybierz pozycję Edytor zapytań i zaloguj się jako administrator bazy danych.

3. Wybierz Nowe zapytanie i uruchom następujące polecenie, aby utworzyć dane początkowe w bazie danych:

   CREATE TABLE dbo.Books
   (
      Id int IDENTITY(1,1) PRIMARY KEY,
      Title nvarchar(200) NOT NULL
   );
   
   INSERT INTO dbo.Books (Title) VALUES (N'The little prince');
   INSERT INTO dbo.Books (Title) VALUES (N'Pride and prejudice');
   

Generowanie pliku konfiguracji języka DAB

Serwer MCP hostowany w języku SQL jest oparty na narzędziu DATA API Builder (DAB), który udostępnia bezpieczny interfejs API danych w bazie danych i uwidacznia jego jednostki (tabele) jako narzędzia MCP. Serwer wymaga pliku konfiguracji DAB, który definiuje połączenie z bazą danych oraz encje, które mają zostać udostępnione.

1. Wygeneruj plik konfiguracji języka DAB dla bazy danych i włącz tylko mcp:

   dab init --database-type "mssql" --host-mode "Development" --graphql.enabled false --rest.enabled false --connection-string "<your-sql-connection-string>"
   

   Ponieważ serwer uzyskuje dostęp do bazy danych za pomocą systemowo przypisanej tożsamości zarządzanej (SAMI), parametry połączenia powinien wyglądać jak następujący przykład:

   Server=<your-sql-server>.database.windows.net;Database=<your-database>;Authentication=Active Directory Default;Encrypt=True;TrustServerCertificate=False;
   

2. Dodaj jednostkę Books i powiązane uprawnienie:

   dab add Books --source "dbo.Books" --permissions "anonymous:*"
   

   Aby uzyskać szczegółowe informacje na temat konfigurowania jednostek i uprawnień, zobacz Autoryzacja konstruktora interfejsu API danych.

   Oto przykładowy plik konfiguracji:

   {
      "$schema": "https://github.com/Azure/data-api-builder/releases/download/v1.7.93/dab.draft.schema.json",
      "data-source": {
         "database-type": "mssql",
         "connection-string": "Server=<your-sql-server>.database.windows.net;Database=<your-database>;Authentication=Active Directory Default;Encrypt=True;TrustServerCertificate=False;",
         "options": {
            "set-session-context": false
         }
      },
      "runtime": {
         "rest": {
            "enabled": false,
            "path": "/api",
            "request-body-strict": true
         },
         "graphql": {
            "enabled": false,
            "path": "/graphql",
            "allow-introspection": true
         },
         "mcp": {
            "enabled": true,
            "path": "/mcp"
         },
         "host": {
            "cors": {
               "origins": [],
               "allow-credentials": false
            },
            "authentication": {
               "provider": "AppService"
            },
            "mode": "development"
         }
      },
      "entities": {
         "Books": {
            "source": {
               "object": "dbo.Books",
               "type": "table"
            },
            "graphql": {
               "enabled": true,
               "type": {
                  "singular": "Books",
                  "plural": "Books"
               }
            },
            "rest": {
               "enabled": true
            },
            "permissions": [
               {
                  "role": "anonymous",
                  "actions": [
                     {
                     "action": "*"
                     }
                  ]
               }
            ]
         }
      }
   }
   

6. Wyszukaj Playwright i wybierz go, aby utworzyć serwer.

6. Wyszukaj SQL MCP Server i wybierz go, aby utworzyć serwer.

7. W oknie tworzenia wybierz pozycję Zarządzaj tożsamością dla metody uwierzytelniania wychodzącego.

8. Przekaż wygenerowany wcześniej plik konfiguracji daB.

9. Wybierz Utwórz.

Przyznaj tożsamości przestrzeni nazw dostęp do bazy danych

Hostowany serwer SQL używa tożsamości zarządzanej przypisanej przez system (SAMI) przestrzeni nazw, aby uzyskać dostęp do bazy danych. Podczas tworzenia przestrzeni nazw można włączyć usługę SAMI.

Jeśli podczas tworzenia nie włączono usługi SAMI, musisz ją włączyć, przechodząc do wystąpienia przestrzeni nazw w portalu internetowym. W menu po lewej stronie znajdź kartę Tożsamość. Ustaw przełącznik Przypisany przez system na Włączone i zapisz zmiany.

Przejdź do bazy danych SQL w portalu Azure, otwórz edytor zapytań i uruchom następujące polecenie, aby udzielić dostępu do tożsamości zarządzanej:

CREATE USER [<your-connector-namespace-name>] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [<your-connector-namespace-name>];
ALTER ROLE db_datawriter ADD MEMBER [<your-connector-namespace-name>];
GRANT VIEW DEFINITION TO [<your-connector-namespace-name>];

Zastąp <your-connector-namespace-name> nazwą zasobu Connector Namespace.

4. Otwórz tryb agenta Copilot i zapytaj „Jaka jest najbliższa pizzeria do 11 Times Square?”

4. Otwórz tryb agent funkcji Copilot i zapytaj "Jakie tabele są dostępne?"

4. Wywołaj określone narzędzie. Na przykład następujące polecenie wywołuje narzędzie browser_navigate:

   npx @modelcontextprotocol/inspector --cli \
   "<your-mcp-endpoint-url>" \
   --transport http \
   --method tools/call \
   --tool-name browser_navigate \
   --tool-arg url="https://www.google.com/search?q=pizza+near+11+Times+Square+New+York" \
   --header "Authorization: Bearer $MCP_TOKEN"
   

4. Wywołaj określone narzędzie. Na przykład następujące polecenie wywołuje describe_entities narzędzie, aby wyświetlić listę dostępnych jednostek:

   npx @modelcontextprotocol/inspector --cli \
   "<your-mcp-endpoint-url>" \
   --transport http \
   --method tools/call \
   --header "Authorization: Bearer $MCP_TOKEN" \
   --tool-name describe_entities \
   --tool-arg 'nameOnly=true'
   

5. Użyj narzędzia read_records, aby pobrać rekordy z encji (Books):

   npx @modelcontextprotocol/inspector --cli \
   "<your-mcp-endpoint-url>" \
   --transport http \
   --method tools/call \
   --header "Authorization: Bearer $MCP_TOKEN" \
   --tool-name read_records \
   --tool-arg 'entity=Books' \
   --tool-arg 'first=2'
   

Rozwiązywanie problemów z serwerem SQL

Jeśli hostowany serwer MCP SQL nie łączy się ani nie zwraca danych zgodnie z oczekiwaniami, sprawdź następujące elementy:

• Plik konfiguracyjny DAB. Upewnij się, że przekazany plik konfiguracji daB jest prawidłowy, używa poprawnego parametry połączenia i definiuje jednostki i uprawnienia, które mają być uwidocznione.
• Tożsamość zarządzana przypisana przez system. Upewnij się, że w przestrzeni nazw włączono usługę SAMI. Przejdź do wystąpienia obszaru nazw w portalu internetowym, wybierz kartę Tożsamość i upewnij się, że opcja Przypisane przez system jest ustawiona na wartość Włączone.
• Dostęp do bazy danych. Upewnij się, że tożsamości przestrzeni nazw przyznano dostęp do bazy danych. Zobacz Przyznawanie tożsamości przestrzeni nazw dostępu do Twojej bazy danych.