Transport dei server MCP

Panoramica

Feedback
• Transport STDIO (server locali)
Feedback
• Transport HTTP Streamable (standard moderno per server remoti)
Feedback
• Transport SSE (rimosso)

Transport STDIO

Come funziona il transport STDIO

Feedback
1. Bob avvia un server MCP come processo figlio
Feedback
2. La comunicazione avviene attraverso i flussi del processo: Bob scrive sullo STDIN del server, il server risponde sullo STDOUT
Feedback
3. Ogni messaggio è delimitato da un carattere di nuova riga
Feedback
4. I messaggi sono formattati come JSON-RPC 2.0

Client                    Server
  |                         |
  |---- messaggio JSON ---->| (via STDIN)
  |                         | (elabora la richiesta)
  |<---- messaggio JSON ----| (via STDOUT)
  |                         |

Caratteristiche di STDIO

Feedback
• Località: Viene eseguito sulla stessa macchina di Bob
Feedback
• Prestazioni: Latenza e overhead molto bassi (nessuno stack di rete coinvolto)
Feedback
• Semplicità: Comunicazione diretta tra processi senza configurazione di rete
Feedback
• Relazione: Relazione uno-a-uno tra client e server
Feedback
• Sicurezza: Intrinsecamente più sicuro senza esposizione di rete

Quando usare STDIO

Feedback
• Integrazioni locali e strumenti in esecuzione sulla stessa macchina
Feedback
• Operazioni sensibili alla sicurezza
Feedback
• Requisiti di bassa latenza
Feedback
• Scenari a client singolo (un'istanza Bob per server)
Feedback
• Strumenti e script da riga di comando

Esempio di implementazione STDIO

const server = new Server({name: 'local-server', version: '1.0.0'});
// Registra gli strumenti...

// Usa il transport STDIO
const transport = new StdioServerTransport(server);
transport.listen();

Transport HTTP Streamable

Come funziona il transport HTTP Streamable

Feedback
1. Il server fornisce un singolo endpoint HTTP (endpoint MCP) che supporta sia il metodo POST che GET
Feedback
2. Bob invia richieste a questo endpoint MCP tramite HTTP POST
Feedback
3. Il server elabora la richiesta e invia una risposta
Feedback
4. Facoltativamente, il server può usare Server-Sent Events (SSE) sulla stessa connessione per inviare in streaming più messaggi o notifiche a Bob

Client                             Server
  |                                  |
  |---- HTTP POST /mcp_endpoint ---->| (richiesta client)
  |                                  | (elabora la richiesta)
  |<--- Risposta HTTP / Stream SSE --| (risposta / stream server)
  |                                  |

Caratteristiche di HTTP Streamable

Feedback
• Standard moderno: Metodo preferito per le nuove implementazioni di server MCP remoti
Feedback
• Accesso remoto: Può essere ospitato su una macchina diversa da Bob
Feedback
• Scalabilità: Può gestire più connessioni client contemporaneamente
Feedback
• Protocollo: Funziona su HTTP/HTTPS standard
Feedback
• Flessibilità: Supporta richiesta-risposta semplice e streaming avanzato
Feedback
• Endpoint singolo: Usa un singolo percorso URL per tutta la comunicazione MCP
Feedback
• Autenticazione: Può usare meccanismi di autenticazione HTTP standard
Feedback
• Compatibilità con le versioni precedenti: I server possono mantenere la compatibilità con i client HTTP+SSE più vecchi

Quando usare HTTP Streamable

Feedback
• Tutti i nuovi sviluppi di server MCP remoti
Feedback
• Server che richiedono comunicazione robusta, scalabile e flessibile
Feedback
• Integrazioni che potrebbero coinvolgere dati in streaming o notifiche inviate dal server
Feedback
• Servizi pubblici o strumenti centralizzati
Feedback
• Sostituzione delle implementazioni legacy del transport SSE

Esempio di implementazione HTTP Streamable

{
  "mcpServers": {
    "StreamableHTTPMCPName": {
      "httpURL": "http://localhost:8080/mcp"
    }
  }
}

Compatibilità con le versioni precedenti di HTTP+SSE

Transport SSE (rimosso)

Migrazione dal transport SSE

Feedback
• Streamable HTTP: Esponi un singolo endpoint MCP che accetta richieste HTTP POST. Questo è il percorso consigliato per i server remoti. Vedi Transport HTTP Streamable.
Feedback
• STDIO: Se il server viene eseguito localmente sulla stessa macchina di Bob, convertilo in un server STDIO. Vedi Transport STDIO.

Considerazioni sul deployment

STDIO: Deployment locale

Feedback
• Installazione: L'eseguibile del server deve essere installato sulla macchina di ogni utente
Feedback
• Distribuzione: Devi fornire pacchetti di installazione per diversi sistemi operativi
Feedback
• Aggiornamenti: Ogni istanza deve essere aggiornata separatamente
Feedback
• Risorse: Usa la CPU, la memoria e il disco della macchina locale
Feedback
• Controllo accessi: Si basa sui permessi del filesystem della macchina locale
Feedback
• Integrazione: Facile integrazione con le risorse del sistema locale (file, processi)
Feedback
• Esecuzione: Si avvia e si arresta con Bob (ciclo di vita del processo figlio)
Feedback
• Dipendenze: Tutte le dipendenze devono essere installate sulla macchina dell'utente

Feedback
• Viene eseguito sulla tua macchina
Feedback
• Ha accesso diretto al filesystem locale
Feedback
• Si avvia quando necessario da Bob
Feedback
• Non richiede configurazione di rete
Feedback
• Deve essere installato accanto a Bob o tramite un package manager

Remoto: Deployment ospitato

Feedback
• Installazione: Installato una volta su un server, accessibile da molti utenti
Feedback
• Distribuzione: Un singolo deployment serve più client
Feedback
• Aggiornamenti: Gli aggiornamenti centralizzati interessano immediatamente tutti gli utenti
Feedback
• Risorse: Usa le risorse del server, non quelle della macchina locale
Feedback
• Controllo accessi: Gestito tramite sistemi di autenticazione e autorizzazione
Feedback
• Integrazione: Integrazione più complessa con risorse specifiche dell'utente
Feedback
• Esecuzione: Viene eseguito come servizio indipendente (spesso in modo continuo)
Feedback
• Dipendenze: Gestite sul server, non sulle macchine degli utenti

Feedback
• Viene eseguito su un server centrale
Feedback
• Si connette ai database con credenziali lato server
Feedback
• È continuamente disponibile per più utenti
Feedback
• Richiede una corretta configurazione della sicurezza di rete
Feedback
• Viene distribuito tramite tecnologie container o cloud

Approcci ibridi

Feedback
1. STDIO con accesso di rete: Un server STDIO locale che funge da proxy per servizi remoti
Feedback
2. Remoto con comandi locali: Un server remoto che può attivare operazioni sulla macchina client tramite callback
Feedback
3. Pattern gateway: Server STDIO per operazioni locali che si connettono a server remoti per funzioni specializzate

Confronto tra transport

Configurare i transport in Bob Shell