MCP Overview
MCP Overview
Questa documentazione espone un server MCP (Model Context Protocol) che permette ad agenti AI — Claude Code, Cursor, GitHub Copilot e altri — di interrogare la libreria @pzeta/vue-components in modo strutturato, senza dover leggere manualmente le pagine HTML.
Cos'è MCP
Model Context Protocol è uno standard aperto che consente agli strumenti AI di accedere a sorgenti di dati esterne tramite un'interfaccia uniforme. Invece di fare affidamento su ricerche generiche o sulla conoscenza del modello (che può essere obsoleta), l'agente interroga direttamente la fonte autorevole.
Nel caso di @pzeta/vue-components, il server MCP espone la documentazione completa di 115+ componenti Vue 3, composables e sistema temi — sempre aggiornata.
Endpoint esposti
| Endpoint | Descrizione |
|---|---|
/mcp | Server MCP principale (JSON-RPC over HTTP) |
/llms.txt | Indice sintetico della documentazione per LLM |
/llms-full.txt | Documentazione completa in formato testo per LLM |
/api/search.json | Ricerca full-text nella documentazione |
Il server MCP è alimentato da @nuxtjs/mcp-toolkit e il modulo nuxt-llms gestisce la generazione dei file /llms.txt e /llms-full.txt.
Sezioni indicizzate
Il server espone le seguenti sezioni tematiche, filtrate dalla documentazione:
- Getting Started — installazione, configurazione, tree shaking
- Buttons — Button, ButtonGroup, SplitButton e varianti
- Forms — Input, Select, Checkbox, DatePicker e tutti i controlli form
- Layout — Card, Panel, Divider, Grid, Accordion
- Overlays — Dialog, Drawer, Tooltip, Popover
- Feedback — Toast, Message, ProgressBar, Skeleton
- Navigation — Menu, Tabs, Breadcrumb, Stepper
- Data — DataTable, Tree, Timeline, VirtualScroller
- Widgets — Chart, Editor, FileUpload, ImageGallery
- Composables —
useToast,useDialog,useConfirme altri - TypeScript — tipi, interfacce ed enum esportati
- Theming — dark mode, token CSS, personalizzazione Tailwind
- MCP — questa sezione
Vantaggi per gli sviluppatori
Query strutturate: l'agente ottiene dati precisi — props, slot, events, esempi di codice — senza interpretare HTML o Markdown.
Sempre aggiornato: il server MCP legge la documentazione live. Non ci sono ritardi tra una release della libreria e la disponibilità delle informazioni.
Integrazione IDE: una volta configurato il server, puoi fare domande nel chat del tuo IDE e ricevere risposte contestuali al tuo codice corrente.
Nessun hallucination su API: invece di inventare props inesistenti, il modello consulta la sorgente di verità.
URL del server
- Produzione:
https://docscomp.pzeta.it/mcp - Sviluppo locale:
http://localhost:3000/mcp
Vedi le sezioni Claude Code Setup e Cursor Setup per le istruzioni di configurazione specifiche per IDE.