What is docfy-mcp
Server MCP che espone il tuo catalogo OpenAPI come tool per agenti di coding: list_endpoints e get_endpoint.
Cos'è
docfy-mcp è un server MCP (Model Context Protocol): espone un catalogo OpenAPI (idealmente uno già documentato da nestjs-docfy, ma funziona con qualsiasi spec OpenAPI 3.0/3.1 valida) come tool che un agente di coding connesso può chiamare direttamente.
Cinque tool: list_endpoints e get_endpoint per scoprire e ispezionare gli endpoint, lint_spec per controllare la qualità della spec, diff_specs per confrontarla con un'altra versione, e contract_test per validare un server live rispetto alla spec.
Perché esiste
Senza questo, un agente che implementa un client contro la tua API ha due opzioni: indovinare la forma dal contesto, oppure chiedere a una persona di aprire un browser, trovare la Swagger UI, e incollare il pezzo rilevante di nuovo in chat. Entrambe più lente e meno affidabili di una chiamata diretta a un tool.
Come si integra con nestjs-docfy
docfy-mcp è costruito sullo stesso motore document-model usato da docfy-ui: il pacchetto condiviso docfy-core.
L'output di get_endpoint è esattamente lo stesso testo che il pulsante Copy for AI di docfy-ui copia, generato dalla stessa funzione operationToAiText(). I due progetti sono due front end diversi sullo stesso modello: uno per una persona nel browser, uno per un agente su stdio.