Contratto MCP di sola lettura
Contratto MCP di sola lettura — Creare un server MCP minimo in sola lettura. Host, client e server; Strumenti e risorse hanno ruoli diversi; Usare la linea SDK attuale. Esercitazione pratica: Pratica: Contratto MCP di sola lettura.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Host, client e server
- Strumenti e risorse hanno ruoli diversi
- Usare la linea SDK attuale
Host, client e server
MCP definisce la comunicazione tra applicazione AI e server di dati o strumenti. L'host gestisce utente e modello, un client si collega a un server specifico e il server espone capacità consentite. Il protocollo non concede automaticamente accesso al filesystem né paga inferenze. Il laboratorio restituisce solo due note operative fittizie in memoria. Non legge home, esegue shell o usa rete, mantenendo il confine interamente verificabile prima di aggiungere archivi.
Strumenti e risorse hanno ruoli diversi
Lo strumento lookup_note accetta noteId e restituisce una nota; lab://policy è una risorsa con URI fisso letta come contesto. Una URI non deve essere un indirizzo browser o file. ReadOnlyHint descrive l'intenzione, non impone permessi del sistema operativo. Servono codice e privilegi del processo. Anche sola lettura può divulgare testi privati all'host, quindi richiede autorizzazione. Il catalogo contiene soltanto note didattiche dichiarate, senza credenziali reali o dati personali.
Usare la linea SDK attuale
La documentazione verificata descrive MCP2026-07-28 e SDK TypeScript v2 stabile con pacchetti server e client separati. Il vecchio @modelcontextprotocol/sdk appartiene a v1: non mescolarne gli import con v2. Usa JavaScript ESM su Node supportato e Zod4, registrando dipendenze risolte nel lockfile. Installare la libreria non dimostra la negoziazione moderna con qualunque avvio. La factory serveStdio e la connessione legacy hanno comportamenti diversi, da verificare esplicitamente nei prossimi controlli.
npm init -y
npm pkg set type=module
npm install --save-exact @modelcontextprotocol/server @modelcontextprotocol/client zod@4
npm install --save-dev --save-exact @modelcontextprotocol/inspector
Esercitazione pratica
Pratica: Contratto MCP di sola lettura
Vai alla lezione