What is docfy-mcp
MCP-server die je OpenAPI-catalogus als tools aanbiedt aan coding agents: list_endpoints en get_endpoint.
Wat het is
docfy-mcp is een MCP-server (Model Context Protocol): hij stelt een OpenAPI-catalogus (idealiter een die nestjs-docfy al gedocumenteerd heeft, maar elke geldige OpenAPI 3.0/3.1-spec werkt) beschikbaar als tools die een verbonden coding agent rechtstreeks kan aanroepen.
Vijf tools: list_endpoints en get_endpoint om endpoints te ontdekken en te inspecteren, lint_spec om de speckwaliteit te checken, diff_specs om tegen een andere versie te vergelijken, en contract_test om een live server te valideren tegen de spec.
Waarom dit bestaat
Zonder dit heeft een agent die een client tegen je API implementeert twee opties: de vorm raden op basis van context, of een mens vragen een browser te openen, de Swagger UI op te zoeken, en het relevante stukje terug te plakken in de chat. Beide zijn trager en minder betrouwbaar dan een directe tool-aanroep.
Hoe het past bij nestjs-docfy
docfy-mcp is gebouwd op dezelfde document-model-engine die docfy-ui gebruikt: het gedeelde pakket docfy-core.
De output van get_endpoint is exact dezelfde tekst die de Copy for AI-knop van docfy-ui kopieert, gegenereerd door dezelfde operationToAiText()-functie. De twee projecten zijn twee verschillende front ends op hetzelfde model: één voor een mens in een browser, één voor een agent over stdio.