What is docfy-mcp
MCP-Server, der deinen OpenAPI-Katalog als Tools für Coding-Agents bereitstellt: list_endpoints und get_endpoint.
Was es ist
docfy-mcp ist ein MCP-Server (Model Context Protocol): Er stellt einen OpenAPI-Katalog (idealerweise einen, den nestjs-docfy bereits dokumentiert hat, aber jede gültige OpenAPI-3.0/3.1-Spec funktioniert) als Tools bereit, die ein verbundener Coding-Agent direkt aufrufen kann.
Fünf Tools: list_endpoints und get_endpoint zum Entdecken und Inspizieren von Endpunkten, lint_spec zur Prüfung der Spec-Qualität, diff_specs zum Vergleich mit einer anderen Version und contract_test zur Validierung eines laufenden Servers gegen die Spec.
Warum es das gibt
Ohne das hat ein Agent, der einen Client gegen deine API implementiert, zwei Optionen: die Form aus dem Kontext raten, oder einen Menschen bitten, einen Browser zu öffnen, die Swagger UI zu finden und den relevanten Teil in den Chat zu kopieren. Beides ist langsamer und unzuverlässiger als ein direkter Tool-Aufruf.
Wie es zu nestjs-docfy passt
docfy-mcp baut auf derselben Document-Model-Engine wie docfy-ui: dem gemeinsamen Paket docfy-core.
Die Ausgabe von get_endpoint ist exakt derselbe Text, den der Copy for AI-Button von docfy-ui kopiert, erzeugt von derselben operationToAiText()-Funktion. Die beiden Projekte sind zwei unterschiedliche Frontends auf demselben Modell: eins für einen Menschen im Browser, eins für einen Agent über stdio.