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.
Cinco tools: list_endpoints e get_endpoint pra descobrir e inspecionar endpoints, lint_spec pra checar qualidade da spec, diff_specs pra comparar contra outra versão, e contract_test pra validar um servidor ao vivo contra a spec.
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.