Lezione gratuita

Catalogo e schema degli argomenti

Catalogo e schema degli argomenti — Creare un server MCP minimo in sola lettura. Iniziare con una ricerca pura; Rendere lo schema eseguibile; Evitare API di percorso arbitrarie. Esercitazione pratica: Pratica: Catalogo e schema degli argomenti.

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Iniziare con una ricerca pura
  • Rendere lo schema eseguibile
  • Evitare API di percorso arbitrarie

Iniziare con una ricerca pura

Salva catalog.mjs. La ricerca restituisce un oggetto nuovo da una mappa esplicita, evitando modifiche al catalogo tramite il riferimento restituito. Esistono solo safety e backup. Altri identificativi producono note_not_found senza cercare file. Le note spiegano regole, non fatti verificati sul tuo VPS. Non aggiungere configurazioni con credenziali. Introducendo un database conserva il contratto ristretto invece di sostituirlo con SQL o shell arbitrari richiesti dal modello.

// catalog.mjs
const notes = new Map([
  ['safety', { id: 'safety', text: 'Educational rule: keep model services private.' }],
  ['backup', { id: 'backup', text: 'Educational rule: test recovery on a separate copy.' }]
]);
export function lookupNote(id) {
  const note = notes.get(id);
  if (!note) throw new Error('note_not_found');
  return { ...note };
}

Rendere lo schema eseguibile

Usa un enum Zod per noteId e un oggetto strict per rifiutare path o command aggiuntivi. La descrizione spiega lo scopo ma non sostituisce la validazione. Lo schema di uscita definisce id e text per structuredContent. Risolvi divergenze tra schema e gestore prima del modello. Prova safety positivamente e rifiuta ../../secret, ID mancanti o comandi aggiuntivi. Verifica anche la funzione pura: il controllo SDK non deve essere l'unica barriera se altri chiamanti riusano il codice.

Evitare API di percorso arbitrarie

Anche read_file può esporre chiavi SSH o .env. Il primo server non richiede percorsi arbitrari. Un futuro accesso ai file deve associare ID consentiti a percorsi espliciti, risolvere percorsi reali e symlink, controllare il confine e limitare la lettura. Un prefisso confrontato come semplice stringa non basta. I permessi del sistema devono impedire indipendentemente letture di segreti. Qui non esiste filesystem: un identificativo con traversal fallisce senza aprire alcun file.

Esercitazione pratica

Pratica: Catalogo e schema degli argomenti

Vai alla lezione

Programma del corso

  1. Contratto MCP di sola lettura
  2. Catalogo e schema degli argomenti
  3. Registrare strumento e risorsa reali
  4. Stdio, HTTP e negoziazione
  5. Test del protocollo senza modello
  6. Collegamento client e verifica