Dela via

Kom igång med Azure MCP Server med Visual Studio

Azure MCP Server använder Model Context Protocol (MCP) för att standardisera integreringar mellan AI-appar och externa verktyg och datakällor, vilket gör det möjligt för AI-system att utföra åtgärder som är sammanhangsmedvetna om dina Azure-resurser.

I den här artikeln får du lära dig hur du utför följande uppgifter:

  • Installera och autentisera till Azure MCP-servern.
  • Anslut till Azure MCP Server med hjälp av GitHub Copilot-agentläget i Visual Studio.
  • Kör uppmaningar för att testa Azure MCP Server-åtgärder och interagera med Azure-resurser.

Förutsättningar

Installera Azure MCP Server

Visual Studio använder en fil med namnet mcp.json för att söka efter MCP Server-konfigurationer, inklusive konfigurationer som konfigurerats av andra utvecklingsmiljöer. Konfigurationerna för MCP-servern läses från följande kataloger i följande ordning:

  1. %USERPROFILE%\.mcp.json: Fungerar som en global MCP-serverkonfiguration för en specifik användare. Lägg till en MCP-server här så att den läses in för alla Visual Studio-lösningar.
  2. <SOLUTIONDIR>\.vs\mcp.json: Specifikt för Visual Studio och läser bara in de angivna MCP-servrarna för en specifik användare för den angivna lösningen.
  3. <SOLUTIONDIR>\.mcp.json: En MCP-konfiguration på lösningsnivå som du kan spåra i källkontrollen för en lagringsplats.
  4. <SOLUTIONDIR>\.vscode\mcp.json: Begränsad till lagringsplatsen/lösningen och ingår vanligtvis inte i källkontrollen.
  5. <SOLUTIONDIR>\.cursor\mcp.json: Begränsad till lagringsplatsen/lösningen och ingår vanligtvis inte i källkontrollen.

Anmärkning

Vissa av dessa platser kräver .mcp.json medan andra kräver mcp.json.

Azure MCP Server är tillgängligt som ett NuGet-paket eller som ett NPM-paket. Följande alternativ visar två av de vanligaste metoderna för att ansluta till Azure MCP Server från Visual Studio.

Utför följande steg för att installera Azure MCP Server för en specifik katalog:

  1. Skapa en ny fil i roten av lösningen med namnet .mcp.json. Använd Visual Studio för att redigera den här filen så att dess JSON-schema tillämpas automatiskt.

  2. .mcp.json I filen lägger du till följande JSON för önskat paket:

    NuGet:

    {
  "servers": {
      "Azure MCP Server": {
          "command": "dnx",
          "args": [
              "Azure.Mcp",
              "--source",
              "https://api.nuget.org/v3/index.json",
              "--yes",
              "--",
              "azmcp",
              "server",
              "start"
          ],
          "type": "stdio"
      }
  }
}

    NPM:

    {
  "servers": {
    "Azure MCP Server": {
      "command": "npx",
      "args": [
        "-y",
        "@azure/mcp@latest",
        "server",
        "start"
      ]
    }
  }
}

  3. Spara dina ändringar.

  4. Öppna GitHub Copilot och välj Agentläge.

  5. Välj verktygsikonen för att visa de tillgängliga verktygen. Sök efter Azure MCP Server för att filtrera resultatet.

En skärmbild som visar hur du konfigurerar Azure MCP Server i Visual Studio.

Autentisera till Azure

Azure MCP Server ger en sömlös autentiseringsupplevelse med hjälp av Azure-konton och Microsoft Entra-ID. Om du vill använda Azure MCP Server måste du först autentisera till Azure med hjälp av lokala utvecklingsverktyg som Azure CLI, Azure Developer CLI, Visual Studio eller Visual Studio Code. Azure MCP Server identifierar automatiskt dina autentiseringsuppgifter från dessa verktyg och använder dem för att autentisera till Azure-tjänster.

  1. Om du till exempel vill logga in med hjälp av Azure CLI:

    az login

  2. Kontrollera autentiseringsstatusen genom att köra följande kommando för att se vilket konto och vilken prenumeration du för närvarande är inloggad med:

    az account show

  3. Se till att ditt användarkonto har rätt rolltilldelningar för de Azure-tjänster som du vill interagera med. De Azure-resurser som du tänker komma åt med Azure MCP Server måste redan finnas i din Azure-prenumeration. Vanliga rolltilldelningar är till exempel:

    • Blob Storage-datadeltagare – Läsa och skriva blobdata i lagringskonton.
    • Lagringskontodeltagare – Hantera lagringskontokonfigurationer.
    • Deltagare – Allmän resurshantering i hela prenumerationen.
    • Läsare – Skrivskyddad åtkomst till Azure-resurser.

    Mer information om rolltilldelningar och lokal utvecklingsautentisering finns i Autentisera .NET-appar till Azure-tjänster under lokal utveckling.

Använd anvisningarna för att testa Azure MCP-servern

  1. Öppna GitHub Copilot och välj Agentläge.

  2. Ange en uppmaning som gör att agenten använder Azure MCP Server-verktyg, till exempel Lista mina Azure-resursgrupper.

  3. För att autentisera Azure MCP Server uppmanar Copilot dig att logga in på Azure med hjälp av webbläsaren.

    Anmärkning

    Copilot uppmanar dig inte att logga in på Azure om du redan har autentiserats via andra lokala verktyg som Azure CLI.

  4. Copilot begär behörighet att köra den nödvändiga Azure MCP Server-åtgärden för din fråga. Välj Tillåt den här gången eller använd pilen för att välja ett mer specifikt beteende:

    • Tillåt alltid att åtgärden alltid körs för alla GitHub Copilot-agentlägessessioner eller visual Studio Code-arbetsytor.
    • Tillåt i den här sessionen kör alltid åtgärden i den aktuella GitHub Copilot-agentlägessessionen.

    En skärmbild som visar hur du kör Azure MCP Server-verktyg i Visual Studio.

    Utdata för föregående fråga bör likna följande text:

    The following resource groups are available for your subscription:

1. **DefaultResourceGroup-EUS** (Location: `eastus`)
2. **rg-testing** (Location: `centralus`)
3. **rg-azd** (Location: `eastus2`)
4. **msdocs-sample** (Location: `southcentralus`)
5. **ai-testing** (Location: `eastus2`)

Let me know if you need further details or actions related to any of these resource groups!

  5. Utforska och testa Azure MCP-åtgärder med hjälp av andra relevanta frågor, till exempel:

    List all of the storage accounts in my subscription
Get the available tables in my storage accounts

Nästa steg

Läs mer om Azure MCP Server-verktyg