Quickstart: Erstellen Sie einen gehosteten MCP-Server im Connector Namespace (Vorschau)

Bereitstellen mithilfe der Azure Developer CLI

Der einfachste Weg, einen SQL MCP-Server zu deployen, ist, zum Beispiel azure-sql-mcp zu gehen und den README-Anweisungen zu folgen, um mit der Azure Developer CLI oder azd. zu deployen. Das Beispiel enthält Bicep-Dateien, die es ermöglichen, mit nur einem Befehl einen Connector Namespace, einen SQL MCP-Server, eine SQL-Datenbank und andere erforderliche Azure-Ressourcen bereitzustellen.

Wenn Sie lieber einen SQL-MCP-Server und benötigte Ressourcen von Anfang bis Ende bereitstellen möchten, folgen Sie den untenstehenden Anweisungen.

• Ein Azure SQL-Datenbank Server mit einer Datenbank. Wenn Sie nicht über eine datenbank verfügen, create an Azure SQL database.

• Data API Builder (DAB) CLI installiert.

Seeden der SQL-Datenbank

1. Wechseln Sie im Azure-Portal zu Ihrer SQL-Datenbank (nicht zum Server).

2. Wählen Sie im linken Menü den Abfrage-Editor aus, und melden Sie sich als Datenbankadministrator an.

3. Wählen Sie "Neue Abfrage" aus, und führen Sie den folgenden Befehl aus, um die Datenbank zu starten:

   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');
   

Generieren der DAB-Konfigurationsdatei

Der von SQL gehostete MCP-Server basiert auf dem Daten-API-Generator (DAB), der eine sichere Daten-API über Ihre Datenbank bereitstellt und seine Entitäten (Tabellen) als MCP-Tools verfügbar macht. Der Server erfordert eine DAB-Konfigurationsdatei, die die Datenbankverbindung und die Entitäten definiert, die verfügbar gemacht werden sollen.

1. Generieren Sie eine DAB-Konfigurationsdatei für Ihre Datenbank, und aktivieren Sie nur MCP:

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

   Da der Server über eine systemzugewiesene verwaltete Identität (SAMI) auf die zugrunde liegende Datenbank zugreift, sollte die Verbindungszeichenfolge wie folgt aussehen:

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

2. Entität "Bücher" und zugehörige Berechtigung hinzufügen:

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

   Ausführliche Informationen zum Konfigurieren von Entitäten und Berechtigungen finden Sie in der Autorisierung des Daten-API-Generators.

   Hier ist eine Beispielkonfigurationsdatei:

   {
      "$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. Suchen Sie nach Playwright , und wählen Sie sie aus, um den Server zu erstellen.

6. Suche nach SQL MCP Server und wähle ihn aus, um den Server zu erstellen.

7. Wählen Sie im Erstellungsfenster "Identität für die ausgehende Authentifizierungsmethode verwalten" aus.

8. Laden Sie die zuvor generierte DAB-Konfigurationsdatei hoch.

9. Wählen Sie "Erstellen" aus.

Gewähren des Namespaceidentitätszugriffs auf Ihre Datenbank

Der gehostete SQL-Server verwendet das SAMI des Namespaces, um auf Ihre Datenbank zuzugreifen. Sie können ein SAMI während der Namespaceerstellung aktivieren.

Wenn Sie ein SAMI während der Erstellung nicht aktiviert haben, müssen Sie es aktivieren, indem Sie zur Namespaceinstanz im Webportal wechseln. Suchen Sie im linken Menü die Registerkarte " Identität ". Schalten Sie den Umschalter "System zugewiesen " auf "Ein ", und speichern Sie das Update.

Wechseln Sie im Azure-Portal zu Ihrer SQL-Datenbank, öffnen Sie den Abfrage-Editor, und führen Sie den folgenden Befehl aus, um Zugriff auf die verwaltete Identität zu gewähren:

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>];

Ersetzen Sie <your-connector-namespace-name> durch den Namen Ihrer Connector-Namespace-Ressource.

4. Öffnen Sie den Copilot-Agent-Modus und fragen Sie: „Was ist die nächstgelegene Pizzeria zu 11 Times Square?“

4. Öffnen Sie Copilot-Agent Modus, und fragen Sie "Welche Tabellen sind verfügbar?"

4. Rufen Sie ein bestimmtes Tool auf. Beispielsweise ruft der folgende Befehl das browser_navigate Tool auf:

   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. Rufen Sie ein bestimmtes Tool auf. Beispielsweise ruft der folgende Befehl das describe_entities Tool auf, um verfügbare Entitäten auflisten zu können:

   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. Rufen Sie das read_records Tool auf, um Datensätze aus einer Entität abzurufen (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'
   

Problembehandlung für den SQL-Server

Wenn Ihr gehosteter SQL MCP-Server keine Verbindung herstellt oder wie erwartet Daten zurückgibt, überprüfen Sie die folgenden Elemente:

• DAB-Konfigurationsdatei. Vergewissern Sie sich, dass die hochgeladene DAB-Konfigurationsdatei gültig ist, die richtige Verbindungszeichenfolge verwendet und die Entitäten und Berechtigungen definiert, die Sie verfügbar machen möchten.
• Vom System zugewiesene verwaltete Identität. Stellen Sie sicher, dass ein SAMI im Namespace aktiviert ist. Wechseln Sie im Webportal zu Ihrer Namespaceinstanz, wählen Sie die Registerkarte " Identität " aus, und vergewissern Sie sich, dass " System zugewiesen " auf "Ein" festgelegt ist.
• Datenbankzugriff. Stellen Sie sicher, dass der Namespaceidentität Zugriff auf die Datenbank gewährt wird. Siehe Gewähren Sie der Namespaceidentität Zugriff auf Ihre Datenbank.