Panoramica delle associazioni degli strumenti MCP per Funzioni di Azure

Il protocollo MCP (Model Context Protocol) è un protocollo client-server progettato per consentire ai modelli linguistici e agli agenti di individuare e usare in modo più efficiente origini dati e strumenti esterni.

Importante

L'estensione MCP di Funzioni di Azure è attualmente in anteprima. È possibile prevedere modifiche alle API di trigger e binding fino a quando l'estensione non diventa disponibile a livello generale.
È consigliabile evitare di usare le estensioni di anteprima nelle app di produzione.

L'estensione MCP di Funzioni di Azure consente di usare Funzioni di Azure per creare server MCP remoti. L'app per le funzioni implementa un server MCP remoto esponendo un set di endpoint implementati come funzioni trigger dello strumento MCP. I client MCP, ad esempio modelli di linguaggio e agenti, possono eseguire query e accedere a questi strumenti per eseguire attività specifiche, ad esempio l'archiviazione o l'accesso ai frammenti di codice. I client MCP possono anche sottoscrivere l'app per ricevere notifiche sulle modifiche apportate agli strumenti esposti.

Importante

L'estensione MCP attualmente non supporta le app di PowerShell.

Prerequisiti

• Il trigger dello strumento MCP si basa sull'archiviazione code di Azure fornita dall'account di archiviazione host predefinito (AzureWebJobsStorage). Quando si usano le identità gestite, assicurarsi che l'app per le funzioni abbia almeno l'equivalente di queste autorizzazioni basate su ruoli nell'account di archiviazione host: Lettore dati coda diarchiviazione e Processore messaggi di accodamento archiviazione.
• Quando si esegue localmente, l'estensione MCP richiede la versione 4.0.7030 di Azure Functions Core Tools o una versione successiva.

• Richiede la versione 2.0.2 o successiva del Microsoft.Azure.Functions.Worker.Sdk pacchetto.

Installare l'estensione

Suggerimento

L'estensione MCP di Funzioni di Azure supporta solo il modello di lavoro isolato.

Aggiungere l'estensione al progetto installando questo pacchetto NuGet nel modo preferito:

Microsoft.Azure.Functions.Worker.Extensions.Mcp

Installare il bundle

L'anteprima dell'estensione MCP fa parte di un bundle di estensione sperimentale, specificato nel file di progetto host.json.

Per usare questo bundle sperimentale nell'app, sostituire l'oggetto esistente extensionBundle nel file host.json del progetto con questo oggetto JSON:

"extensionBundle": {
  "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
  "version": "[4.*, 5.0.0)"
}

impostazioni host.json

Questa sezione descrive le impostazioni di configurazione disponibili per questa associazione nella versione 2.x e successive. Le impostazioni nel file host.json si applicano a tutte le funzioni in un'istanza dell'app per le funzioni. Per altre informazioni sulle impostazioni di configurazione dell'app per le funzioni, vedere informazioni di riferimentohost.json per Funzioni di Azure.

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

Proprietà	Descrizione
disposizioni	Descrive ai client come accedere al server MCP remoto.
serverName	Nome descrittivo per il server MCP remoto.
serverVersion	Versione corrente del server MCP remoto.

Articoli correlati

Creare un endpoint dello strumento nel server MCP remoto