Skip to content

Latest commit

 

History

History
171 lines (129 loc) · 6.26 KB

complete_examples.md

File metadata and controls

171 lines (129 loc) · 6.26 KB

Esempi Completi di Client MCP

Questa directory contiene esempi completi e funzionanti di client MCP in diversi linguaggi di programmazione. Ogni client dimostra l'intera funzionalità descritta nel tutorial principale README.md.

Client Disponibili

1. Client Java (client_example_java.java)

  • Trasporto: SSE (Server-Sent Events) su HTTP
  • Server di Destinazione: http://localhost:8080
  • Funzionalità:
    • Stabilire la connessione e inviare ping
    • Elenco degli strumenti
    • Operazioni della calcolatrice (somma, sottrazione, moltiplicazione, divisione, help)
    • Gestione degli errori ed estrazione dei risultati

Per eseguire:

# Ensure your MCP server is running on localhost:8080
javac client_example_java.java
java client_example_java

2. Client C# (client_example_csharp.cs)

  • Trasporto: Stdio (Input/Output Standard)
  • Server di Destinazione: Server MCP .NET locale tramite dotnet run
  • Funzionalità:
    • Avvio automatico del server tramite trasporto stdio
    • Elenco di strumenti e risorse
    • Operazioni della calcolatrice
    • Parsing dei risultati in formato JSON
    • Gestione completa degli errori

Per eseguire:

dotnet run

3. Client TypeScript (client_example_typescript.ts)

  • Trasporto: Stdio (Input/Output Standard)
  • Server di Destinazione: Server MCP Node.js locale
  • Funzionalità:
    • Supporto completo al protocollo MCP
    • Operazioni su strumenti, risorse e prompt
    • Operazioni della calcolatrice
    • Lettura delle risorse ed esecuzione dei prompt
    • Gestione robusta degli errori

Per eseguire:

# First compile TypeScript (if needed)
npm run build

# Then run the client
npm run client
# or
node client_example_typescript.js

4. Client Python (client_example_python.py)

  • Trasporto: Stdio (Input/Output Standard)
  • Server di Destinazione: Server MCP Python locale
  • Funzionalità:
    • Pattern async/await per le operazioni
    • Scoperta di strumenti e risorse
    • Test delle operazioni della calcolatrice
    • Lettura del contenuto delle risorse
    • Organizzazione basata su classi

Per eseguire:

python client_example_python.py

Funzionalità Comuni a Tutti i Client

Ogni implementazione del client dimostra:

  1. Gestione della Connessione

    • Stabilire la connessione al server MCP
    • Gestire errori di connessione
    • Pulizia adeguata e gestione delle risorse

  2. Scoperta del Server

    • Elenco degli strumenti disponibili
    • Elenco delle risorse disponibili (dove supportato)
    • Elenco dei prompt disponibili (dove supportato)

  3. Invocazione degli Strumenti

    • Operazioni base della calcolatrice (somma, sottrazione, moltiplicazione, divisione)
    • Comando help per informazioni sul server
    • Passaggio corretto degli argomenti e gestione dei risultati

  4. Gestione degli Errori

    • Errori di connessione
    • Errori nell'esecuzione degli strumenti
    • Fallimenti gestiti in modo elegante e feedback all'utente

  5. Elaborazione dei Risultati

    • Estrazione del contenuto testuale dalle risposte
    • Formattazione dell'output per una migliore leggibilità
    • Gestione di diversi formati di risposta

Prerequisiti

Prima di eseguire questi client, assicurati di avere:

  1. Il server MCP corrispondente in esecuzione (da ../01-first-server/)
  2. Le dipendenze richieste installate per il linguaggio scelto
  3. Connettività di rete adeguata (per i trasporti basati su HTTP)

Differenze Chiave tra le Implementazioni

Linguaggio Trasporto Avvio del Server Modello Async Librerie Chiave
Java SSE/HTTP Esterno Sincrono WebFlux, MCP SDK
C# Stdio Automatico Async/Await .NET MCP SDK
TypeScript Stdio Automatico Async/Await Node MCP SDK
Python Stdio Automatico AsyncIO Python MCP SDK
Rust Stdio Automatico Async/Await Rust MCP SDK, Tokio

Prossimi Passi

Dopo aver esplorato questi esempi di client:

  1. Modifica i client per aggiungere nuove funzionalità o operazioni
  2. Crea il tuo server e testalo con questi client
  3. Sperimenta con diversi trasporti (SSE vs. Stdio)
  4. Costruisci un'applicazione più complessa che integri la funzionalità MCP

Risoluzione dei Problemi

Problemi Comuni

  1. Connessione rifiutata: Assicurati che il server MCP sia in esecuzione sulla porta/percorso previsto
  2. Modulo non trovato: Installa l'SDK MCP richiesto per il tuo linguaggio
  3. Permesso negato: Controlla i permessi dei file per il trasporto stdio
  4. Strumento non trovato: Verifica che il server implementi gli strumenti previsti

Suggerimenti per il Debug

  1. Abilita il logging dettagliato nel tuo SDK MCP
  2. Controlla i log del server per messaggi di errore
  3. Verifica i nomi e le firme degli strumenti tra client e server
  4. Testa prima con MCP Inspector per validare la funzionalità del server

Documentazione Correlata

Disclaimer (Avviso di esclusione di responsabilità):
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Sebbene ci impegniamo per garantire la massima accuratezza, si prega di notare che le traduzioni automatiche potrebbero contenere errori o imprecisioni. Il documento originale nella sua lingua nativa dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si consiglia di ricorrere a una traduzione professionale eseguita da un traduttore umano. Non siamo responsabili per eventuali malintesi o interpretazioni errate derivanti dall'uso di questa traduzione.