What is docfy-mcp
Servidor MCP que expone tu catálogo OpenAPI como tools para agentes de código: list_endpoints y get_endpoint.
Qué es
docfy-mcp es un servidor MCP (Model Context Protocol): expone un catálogo OpenAPI (idealmente uno que nestjs-docfy ya documentó, pero cualquier spec OpenAPI 3.0/3.1 válida funciona) como tools que un agente de código conectado puede llamar directamente.
Cinco tools: list_endpoints y get_endpoint para descubrir e inspeccionar endpoints, lint_spec para comprobar la calidad de la spec, diff_specs para comparar contra otra versión, y contract_test para validar un servidor en vivo contra la spec.
Por qué existe
Sin esto, un agente que implementa un cliente contra tu API tiene dos opciones: adivinar la forma a partir del contexto, o pedirle a un humano que abra un navegador, encuentre el Swagger UI, y pegue de vuelta el fragmento relevante en el chat. Ambas son más lentas y menos fiables que una llamada directa a una tool.
Cómo encaja con nestjs-docfy
docfy-mcp está construido sobre el mismo motor de document-model que usa docfy-ui: el paquete compartido docfy-core.
La salida de get_endpoint es exactamente el mismo texto que copia el botón Copy for AI de docfy-ui, generado por la misma función operationToAiText(). Los dos proyectos son dos front ends distintos sobre el mismo modelo: uno para un humano en un navegador, otro para un agente por stdio.