What is docfy-mcp
Serveur MCP qui expose ton catalogue OpenAPI comme outils pour des agents de code : list_endpoints et get_endpoint.
Ce que c'est
docfy-mcp est un serveur MCP (Model Context Protocol) : il expose un catalogue OpenAPI (idéalement un déjà documenté par nestjs-docfy, mais n'importe quelle spec OpenAPI 3.0/3.1 valide fonctionne) comme outils qu'un agent de code connecté peut appeler directement.
Cinq outils : list_endpoints et get_endpoint pour découvrir et inspecter les endpoints, lint_spec pour vérifier la qualité de la spec, diff_specs pour comparer avec une autre version, et contract_test pour valider un serveur en direct par rapport à la spec.
Pourquoi ça existe
Sans lui, un agent qui implémente un client contre ton API a deux options : deviner la forme à partir du contexte, ou demander à un humain d'ouvrir un navigateur, de trouver la Swagger UI, et de coller le bout pertinent dans la conversation. Les deux sont plus lentes et moins fiables qu'un appel d'outil direct.
Comment ça s'intègre à nestjs-docfy
docfy-mcp est construit sur le même moteur de modèle de document que docfy-ui utilise : le package partagé docfy-core.
La sortie de get_endpoint est exactement le même texte que copie le bouton Copy for AI de docfy-ui, généré par la même fonction operationToAiText(). Les deux projets sont deux interfaces différentes sur le même modèle : l'une pour un humain dans un navigateur, l'autre pour un agent via stdio.