Schema.gov.it MCP Server

Un server MCP (Model Context Protocol) avanzato per interagire semanticamente con il catalogo dati di schema.gov.it.

Questo server permette agli agenti AI (come Claude Code) di esplorare ontologie, analizzare la copertura dei dati, verificare la qualità e scoprire connessioni tra concetti in modo intelligente.

Strumenti disponibili

Il server espone 47 strumenti organizzati in 12 categorie:

1. Operazioni Base

• query_sparql: Esegue una query SPARQL raw con contesto source. Default: remoto schema.gov.it; supporta anche source="local" con file_path, content o upload_id. source="hybrid" non e’ ancora supportato per SPARQL raw.
• explore_catalog: Elenca i grafi e le ontologie disponibili nell’endpoint.
• explore_classes: Elenca le classi disponibili con conteggio istanze, con filtro opzionale.

2. Analytics Semantiche

• check_coverage: Analizza la copertura di una specifica classe/proprietà, o statistiche globali.
• check_quality: Trova problemi di qualità (label o descrizioni mancanti).
• check_overlaps: Identifica sovrapposizioni (stesse label) o mapping espliciti.

3. Modello Dati (Ontologie)

• list_ontologies: Elenca le ontologie disponibili (es. Città, Servizi Pubblici).
• explore_ontology: Mostra Classi e Proprietà definite in una specifica ontologia.

4. Vocabolari Controllati (Reference Data)

• list_vocabularies: Elenca i vocabolari controllati disponibili (ConceptScheme) con conteggio istanze.
• browse_vocabulary: Naviga un vocabolario con paginazione ed e’ il default consigliato quando conosci gia’ il ConceptScheme. Supporta keyword e lang.
• search_in_vocabulary: Cerca concetti dentro un vocabolario specifico per label; utile quando vuoi una ricerca diretta senza scorrere le pagine. Supporta lang.
• navigate_skos_hierarchy: Naviga la gerarchia skos:broader/skos:narrower a partire da un concetto, con direction e depth.

5. Cataloghi e Dataset (Dati)

• list_datasets: Elenca i dataset DCAT-AP_IT disponibili.
• explore_dataset: Mostra dettagli e distribuzioni di un dataset.
• preview_distribution: Scarica e mostra le prime righe di una distribuzione CSV/JSON.