Översikt över Model Context Protocol-bindningar för Azure Functions

Model Context Protocol (MCP) är ett klient-serverprotokoll som är avsett att göra det möjligt för språkmodeller och agenter att mer effektivt identifiera och använda externa datakällor och verktyg.

Med Azure Functions MCP-tillägget kan du använda Azure Functions för att skapa fjärranslutna MCP-servrar. Dessa servrar kan vara värdar för MCP-verktygsutlösarfunktioner, som MCP-klienter, till exempel språkmodeller och agenter, kan köra frågor mot och få åtkomst till specifika uppgifter.

Prerequisites

• När du använder SSE-transporten förlitar sig MCP-tillägget på Azure Queue Storage som tillhandahålls av standardvärdens lagringskonto (AzureWebJobsStorage). När du använder identitetsbaserade anslutningar kontrollerar du att funktionsappen har minst motsvarande rollbaserade behörigheter i värdlagringskontot: Storage Queue Data Reader och Storage Queue Data Message Processor.
• När du kör lokalt kräver MCP-tillägget version 4.0.7030 av Azure Functions Core Tools eller en senare version.

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.28.0, 5.0.0)"
  }
}

host.json inställningar

I det här avsnittet beskrivs de konfigurationsinställningar som är tillgängliga för den här bindningen i version 2.x och senare. Inställningar i host.json-filen gäller för alla funktioner i en funktionsappinstans. Mer information om konfigurationsinställningar för funktionsappar finns ihost.json referens för Azure Functions.

Du kan använda avsnittet extensions.mcp i host.json för att definiera MCP-serverinformation.

{
  "version": "2.0",
  "extensions": {
    "mcp": {
      "instructions": "Some test instructions on how to use the server",
      "serverName": "TestServer",
      "serverVersion": "2.0.0",
      "encryptClientState": true,
      "messageOptions": {
        "useAbsoluteUriForEndpoint": false
      }
    }    
  }
}

Ansluta till MCP-servern

För att ansluta till MCP-servern som exponeras av funktionsappen måste du ange en MCP-klient med lämplig slutpunkts- och transportinformation. I följande tabell visas de transporter som stöds av Azure Functions MCP-tillägget, tillsammans med deras motsvarande anslutningsslutpunkt.

¹ Nyare protokollversioner har föråldrat transporten Server-Sent Events. Om inte klienten specifikt kräver det bör du använda streambar HTTP-transport i stället.

När slutpunkterna som exponeras av tillägget finns i Azure kräver de även systemnyckeln med namnet mcp_extension. Om den inte anges i x-functions-key HTTP-huvudet eller i frågesträngsparametern code får klienten ett 401 Unauthorized svar. Du kan hämta nyckeln med någon av metoderna som beskrivs i Hämta funktionsåtkomstnycklar. I följande exempel visas hur du hämtar nyckeln med Azure CLI:

az functionapp keys list --resource-group <RESOURCE_GROUP> --name <APP_NAME> --query systemKeys.mcp_extension --output tsv

MCP-klienter accepterar den här konfigurationen på olika sätt. Läs dokumentationen för din valda klient. I följande exempel visas en mcp.json fil som du kan använda för att konfigurera MCP-servrar för GitHub Copilot i Visual Studio Code. I exemplet konfigureras två servrar, båda med hjälp av Streamable HTTP-transporten. Den första är för lokal testning med Azure Functions Core Tools. Den andra är för en funktionsapp som finns i Azure. Konfigurationen tar indataparametrar som Visual Studio Code frågar efter när du kör fjärrservern. Genom att använda indata ser du till att hemligheter som systemnyckeln inte sparas i filen och checkas in i källkontrollen.

{
    "inputs": [
        {
            "type": "promptString",
            "id": "functions-mcp-extension-system-key",
            "description": "Azure Functions MCP Extension System Key",
            "password": true
        },
        {
            "type": "promptString",
            "id": "functionapp-host",
            "description": "The host domain of the function app."
        }
    ],
    "servers": {
        "local-mcp-function": {
            "type": "http",
            "url": "http://localhost:7071/runtime/webhooks/mcp"
        },
        "remote-mcp-function": {
            "type": "http",
            "url": "https://${input:functionapp-host}/runtime/webhooks/mcp",
            "headers": {
                "x-functions-key": "${input:functions-mcp-extension-system-key}"
            }
        }
    }
}

Relaterade artiklar

Skapa en verktygsslutpunkt på din fjärranslutna MCP-server