wehub-resource-sync
7.2 KiB
Testing e Debugging
Prima di iniziare a testare il tuo server MCP, è importante capire gli strumenti disponibili e le migliori pratiche per il debugging. Un testing efficace assicura che il tuo server si comporti come previsto e ti aiuta a identificare e risolvere rapidamente i problemi. La sezione seguente illustra gli approcci consigliati per convalidare la tua implementazione MCP.
Panoramica
Questa lezione tratta come selezionare l'approccio di testing giusto e lo strumento di testing più efficace.
Obiettivi di Apprendimento
Al termine di questa lezione, sarai in grado di:
- Descrivere vari approcci per il testing.
- Utilizzare diversi strumenti per testare efficacemente il tuo codice.
Testing dei Server MCP
MCP fornisce strumenti per aiutarti a testare e fare il debug dei tuoi server:
- MCP Inspector: Uno strumento da linea di comando che può essere eseguito sia come CLI che come strumento visuale.
- Testing manuale: Puoi usare uno strumento come curl per eseguire richieste web, ma qualunque strumento in grado di eseguire HTTP va bene.
- Unit testing: È possibile utilizzare il framework di testing preferito per testare le funzionalità sia del server che del client.
Uso di MCP Inspector
Abbiamo descritto l'uso di questo strumento nelle lezioni precedenti, ma parliamone un po' a livello generale. È uno strumento costruito in Node.js e puoi usarlo chiamando l'eseguibile npx che scaricherà e installerà temporaneamente lo strumento stesso e si ripulirà una volta terminata l'esecuzione della tua richiesta.
Il MCP Inspector ti aiuta a:
- Scoprire le capacità del server: Rilevare automaticamente risorse, strumenti e prompt disponibili
- Testare l'esecuzione degli strumenti: Provare diversi parametri e vedere le risposte in tempo reale
- Visualizzare i metadati del server: Esaminare informazioni sul server, schemi e configurazioni
Una tipica esecuzione dello strumento è la seguente:
npx @modelcontextprotocol/inspector node build/index.js
Il comando sopra avvia un MCP e la sua interfaccia visiva e lancia un'interfaccia web locale nel tuo browser. Puoi aspettarti di vedere una dashboard che mostra i tuoi server MCP registrati, gli strumenti disponibili, le risorse e i prompt. L'interfaccia ti permette di testare interattivamente l'esecuzione degli strumenti, ispezionare i metadati del server e visualizzare risposte in tempo reale, rendendo più facile convalidare e fare il debug delle implementazioni del tuo server MCP.
Ecco come può apparire: 
Puoi anche eseguire questo strumento in modalità CLI, in tal caso aggiungi l'attributo --cli. Ecco un esempio di esecuzione dello strumento in modalità "CLI" che elenca tutti gli strumenti sul server:
npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list
Testing Manuale
Oltre a eseguire lo strumento inspector per testare le capacità del server, un altro approccio simile è eseguire un client in grado di utilizzare HTTP come ad esempio curl.
Con curl, puoi testare i server MCP direttamente usando richieste HTTP:
# Esempio: Metadati del server di test
curl http://localhost:3000/v1/metadata
# Esempio: Eseguire uno strumento
curl -X POST http://localhost:3000/v1/tools/execute \
-H "Content-Type: application/json" \
-d '{"name": "calculator", "parameters": {"expression": "2+2"}}'
Come puoi vedere dall'uso di curl sopra, utilizzi una richiesta POST per invocare uno strumento utilizzando un payload composto dal nome dello strumento e dai suoi parametri. Usa l'approccio che ti si addice di più. In generale gli strumenti CLI tendono a essere più veloci da usare e si prestano ad essere scriptati, cosa che può essere utile in un ambiente CI/CD.
Unit Testing
Crea test unitari per i tuoi strumenti e risorse per assicurarti che funzionino come previsto. Ecco un esempio di codice di testing.
import pytest
from mcp.server.fastmcp import FastMCP
from mcp.shared.memory import (
create_connected_server_and_client_session as create_session,
)
# Segna l'intero modulo per test asincroni
pytestmark = pytest.mark.anyio
async def test_list_tools_cursor_parameter():
"""Test that the cursor parameter is accepted for list_tools.
Note: FastMCP doesn't currently implement pagination, so this test
only verifies that the cursor parameter is accepted by the client.
"""
server = FastMCP("test")
# Crea un paio di strumenti di test
@server.tool(name="test_tool_1")
async def test_tool_1() -> str:
"""First test tool"""
return "Result 1"
@server.tool(name="test_tool_2")
async def test_tool_2() -> str:
"""Second test tool"""
return "Result 2"
async with create_session(server._mcp_server) as client_session:
# Test senza parametro cursor (omesso)
result1 = await client_session.list_tools()
assert len(result1.tools) == 2
# Test con cursor=None
result2 = await client_session.list_tools(cursor=None)
assert len(result2.tools) == 2
# Test con cursor come stringa
result3 = await client_session.list_tools(cursor="some_cursor_value")
assert len(result3.tools) == 2
# Test con cursor stringa vuota
result4 = await client_session.list_tools(cursor="")
assert len(result4.tools) == 2
Il codice precedentemente mostrato fa quanto segue:
- Sfrutta il framework pytest che ti permette di creare test come funzioni e usare istruzioni assert.
- Crea un server MCP con due strumenti differenti.
- Usa l'istruzione
assertper controllare che certe condizioni siano soddisfatte.
Dai un'occhiata al file completo qui
Dato il file sopra, puoi testare il tuo server per assicurarti che le capacità siano create come dovrebbero.
Tutti i principali SDK hanno sezioni di testing simili in modo da poter adattare al runtime scelto.
Esempi
- Calcolatrice Java
- Calcolatrice .Net
- Calcolatrice JavaScript
- Calcolatrice TypeScript
- Calcolatrice Python
Risorse Aggiuntive
Cosa C'è Dopo
- Prossimo: Deployment
Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica AI Co-op Translator. Pur impegnandoci per l'accuratezza, si prega di considerare 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 la traduzione professionale umana. Non ci assumiamo responsabilità per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione.