Skip to content

Latest commit

 

History

History
117 lines (82 loc) · 4.5 KB

README.md

File metadata and controls

117 lines (82 loc) · 4.5 KB

Distribuire i server MCP

Distribuire il tuo server MCP permette ad altri di accedere ai suoi strumenti e risorse oltre il tuo ambiente locale. Ci sono diverse strategie di distribuzione da considerare, a seconda delle tue esigenze di scalabilità, affidabilità e facilità di gestione. Di seguito troverai indicazioni per distribuire i server MCP localmente, in container e sul cloud.

Panoramica

Questa lezione spiega come distribuire la tua app MCP Server.

Obiettivi di apprendimento

Al termine di questa lezione, sarai in grado di:

  • Valutare diversi approcci di distribuzione.
  • Distribuire la tua app.

Sviluppo e distribuzione locale

Se il tuo server è destinato a essere utilizzato eseguendolo sulla macchina degli utenti, puoi seguire questi passaggi:

  1. Scarica il server. Se non hai scritto tu il server, scaricalo prima sulla tua macchina.
  2. Avvia il processo del server: Esegui la tua applicazione MCP server.

Per SSE (non necessario per server di tipo stdio)

  1. Configura la rete: Assicurati che il server sia accessibile sulla porta prevista.
  2. Connetti i client: Usa URL di connessione locali come http://localhost:3000.

Distribuzione sul cloud

I server MCP possono essere distribuiti su diverse piattaforme cloud:

  • Serverless Functions: Distribuisci server MCP leggeri come funzioni serverless.
  • Container Services: Usa servizi come Azure Container Apps, AWS ECS o Google Cloud Run.
  • Kubernetes: Distribuisci e gestisci i server MCP in cluster Kubernetes per alta disponibilità.

Esempio: Azure Container Apps

Azure Container Apps supporta la distribuzione di server MCP. È ancora in fase di sviluppo e attualmente supporta server SSE.

Ecco come procedere:

  1. Clona un repository:
git clone https://github.com/anthonychu/azure-container-apps-mcp-sample.git
  1. Eseguilo localmente per fare dei test:
uv venv
uv sync

# linux/macOS
export API_KEYS=<AN_API_KEY>
# windows
set API_KEYS=<AN_API_KEY>

uv run fastapi dev main.py
  1. Per provarlo localmente, crea un file mcp.json in una cartella .vscode e aggiungi il seguente contenuto:
{
    "inputs": [
        {
            "type": "promptString",
            "id": "weather-api-key",
            "description": "Weather API Key",
            "password": true
        }
    ],
    "servers": {
        "weather-sse": {
            "type": "sse",
            "url": "http://localhost:8000/sse",
            "headers": {
                "x-api-key": "${input:weather-api-key}"
            }
        }
    }
}

Una volta avviato il server SSE, puoi cliccare sull’icona play nel file JSON; ora dovresti vedere gli strumenti sul server riconosciuti da GitHub Copilot, vedi l’icona Tool.

  1. Per distribuire, esegui il seguente comando:
az containerapp up -g <RESOURCE_GROUP_NAME> -n weather-mcp --environment mcp -l westus --env-vars API_KEYS=<AN_API_KEY> --source .

Ecco fatto, distribuiscilo localmente o su Azure seguendo questi passaggi.

Risorse aggiuntive

Cosa c’è dopo

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