What is docfy-mcp
Servidor MCP que expõe seu catálogo OpenAPI como tools para agentes de código — list_endpoints e get_endpoint.
O que é
docfy-mcp é um servidor MCP (Model Context Protocol): expõe um catálogo OpenAPI — idealmente um que o nestjs-docfy já documentou, mas qualquer spec OpenAPI 3.0/3.1 válida funciona — como tools que um agente de código conectado (Claude Code, Cursor, …) pode chamar direto.
Duas tools: list_endpoints pra descobrir o que existe, e get_endpoint pra pegar o formato completo de request/response de um deles.
Por que existe
Sem isso, um agente implementando um client contra sua API tem duas opções: chutar o formato pelo contexto, ou pedir pra um humano abrir o navegador, achar o Swagger UI e colar o trecho relevante de volta no chat. Os dois são mais lentos e menos confiáveis que uma chamada de tool direta.
Como se encaixa com o nestjs-docfy
docfy-mcp é construído sobre o mesmo motor de document-model que o docfy-ui usa — o pacote compartilhado docfy-core.
A saída do get_endpoint é exatamente o mesmo texto que o botão Copy for AI do docfy-ui copia, gerado pela mesma função operationToAiText(). Os dois projetos são duas frentes diferentes sobre o mesmo modelo: uma pra um humano no navegador, outra pra um agente via stdio.