Verificare il caricamento e l'elenco degli strumenti

Il server è in esecuzione, ma come può sapere se funziona correttamente? Verifichiamo che venga caricato e che lo strumento sia visibile ai client. 🔍

Il SDK include uno strumento di supporto. Eseguendo mcp dev sul file, avvia il server con un inspector visivo collegato.

Nel browser si apre MCP Inspector: un pannello intuitivo per provare il server senza scrivere codice client.

Nell'Inspector faccia clic su Connect. In questo modo viene eseguito l'handshake; se ha esito positivo, il server è stato caricato e comunica correttamente tramite MCP.

Ora passi alla scheda Tools. Questa invia l'operazione di elenco del protocollo e mostra ogni strumento pubblicizzato dal server.

Dovrebbe trovare la funzione nell'elenco in base al suo nome, ad esempio "hello" o "greet", insieme alla descrizione ricavata dalla docstring.

Faccia clic sullo strumento: Inspector mostrerà il suo schema, cioè i parametri tipizzati che FastMCP ha creato dai suggerimenti di tipo. È questo che legge il modello.

Inserisca gli argomenti necessari e prema run. Inspector richiama lo strumento e mostra il risultato esatto che riceverebbe il modello.

Se l'elenco Tools è vuoto, probabilmente il decoratore non è stato eseguito. Verifichi che @mcp.tool() si trovi direttamente sopra la funzione.

Quella scheda è semplicemente un'interfaccia per un messaggio reale: il client invia una richiesta tools/list e il server risponde con il catalogo.

Inspector non serve solo per gli strumenti. Contiene anche schede per resources e prompt, così può verificare ogni funzionalità esposta dal server.

Ha avviato mcp dev, si è connesso in Inspector, ha visto lo strumento nell'elenco e lo ha persino chiamato dal vivo. Il suo primo server è reale e verificato. Complimenti! 🎉