Skip to content

Latest commit

 

History

History
107 lines (75 loc) · 5.21 KB

README.md

File metadata and controls

107 lines (75 loc) · 5.21 KB

Esempio

L'esempio precedente mostra come utilizzare un progetto .NET locale con il tipo stdio. E come eseguire il server localmente in un container. Questa è una buona soluzione in molte situazioni. Tuttavia, può essere utile avere il server in esecuzione da remoto, ad esempio in un ambiente cloud. Qui entra in gioco il tipo http.

Guardando la soluzione nella cartella 04-PracticalImplementation, potrebbe sembrare molto più complessa della precedente. Ma in realtà non lo è. Se guardi attentamente il progetto src/Calculator, vedrai che è sostanzialmente lo stesso codice dell'esempio precedente. L'unica differenza è che stiamo usando una libreria diversa ModelContextProtocol.AspNetCore per gestire le richieste HTTP. E modifichiamo il metodo IsPrime rendendolo privato, solo per mostrare che nel tuo codice puoi avere metodi privati. Il resto del codice è uguale a prima.

Gli altri progetti provengono da .NET Aspire. Avere .NET Aspire nella soluzione migliorerà l’esperienza dello sviluppatore durante lo sviluppo e il testing e aiuterà con l’osservabilità. Non è necessario per eseguire il server, ma è buona pratica averlo nella soluzione.

Avviare il server localmente

  1. Da VS Code (con l’estensione C# DevKit), naviga nella directory 04-PracticalImplementation/samples/csharp.

  2. Esegui il comando seguente per avviare il server:

     dotnet watch run --project ./src/AppHost

  3. Quando un browser web apre la dashboard di .NET Aspire, prendi nota dell’URL http. Dovrebbe essere qualcosa come http://localhost:5058/.

    Dashboard di .NET Aspire

Testare Streamable HTTP con MCP Inspector

Se hai Node.js 22.7.5 o superiore, puoi usare MCP Inspector per testare il tuo server.

Avvia il server ed esegui il comando seguente in un terminale:

npx @modelcontextprotocol/inspector http://localhost:5058

MCP Inspector

  • Seleziona Streamable HTTP as the Transport type.
  • In the Url field, enter the URL of the server noted earlier, and append /mcp. Dovrebbe essere http (non https) something like http://localhost:5058/mcp.
  • select the Connect button.

A nice thing about the Inspector is that it provide a nice visibility on what is happening.

  • Try listing the available tools
  • Try some of them, it should works just like before.

Test MCP Server with GitHub Copilot Chat in VS Code

To use the Streamable HTTP transport with GitHub Copilot Chat, change the configuration of the calc-mcp server creato precedentemente per apparire così:

// .vscode/mcp.json
{
  "servers": {
    "calc-mcp": {
      "type": "http",
      "url": "http://localhost:5058/mcp"
    }
  }
}

Esegui alcuni test:

  • Chiedi "3 numeri primi dopo 6780". Nota come Copilot utilizzerà i nuovi strumenti NextFivePrimeNumbers e restituirà solo i primi 3 numeri primi.
  • Chiedi "7 numeri primi dopo 111", per vedere cosa succede.
  • Chiedi "John ha 24 lecca-lecca e vuole distribuirli tutti ai suoi 3 figli. Quanti lecca-lecca riceve ciascun figlio?", per vedere cosa succede.

Distribuire il server su Azure

Distribuiamo il server su Azure così più persone potranno usarlo.

Da un terminale, naviga nella cartella 04-PracticalImplementation/samples/csharp ed esegui il comando seguente:

azd up

Al termine della distribuzione, dovresti vedere un messaggio come questo:

Distribuzione Azd riuscita

Prendi l’URL e usalo in MCP Inspector e in GitHub Copilot Chat.

// .vscode/mcp.json
{
  "servers": {
    "calc-mcp": {
      "type": "http",
      "url": "https://calc-mcp.gentleriver-3977fbcf.australiaeast.azurecontainerapps.io/mcp"
    }
  }
}

Cosa c’è dopo?

Proviamo diversi tipi di trasporto e strumenti di test. Distribuiamo anche il tuo server MCP su Azure. Ma cosa succede se il nostro server deve accedere a risorse private? Per esempio, un database o un’API privata? Nel prossimo capitolo vedremo come possiamo migliorare la sicurezza del nostro server.

Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Pur impegnandoci per garantire l’accuratezza, si prega di considerare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua madre deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda la traduzione professionale effettuata da un umano. Non ci assumiamo alcuna responsabilità per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione.