coryjs-docfy:模拟服务器,合同测试,以及更锋利的MCP服务器

2026年8月2日6 次浏览来源:Dev.to阅读原文

几周前我在这里分享了"巢"-docfy——一个将斯瓦格装饰器从"巢"(NestJS)控制器中移出到伴行文件的库,Docfy-ui作为AI-第一参考UI,Docfy-mcp将你的API目录通过/.

此后CLI围绕光谱本身发展出全本地的dev工作流程,Docfy-mcp从"读出道克"到"验证API说的是实话". :一个没有服务器的服务器从您OpenAPI文档中直接旋转出一个被丢弃的HTTP服务器——每个路径返回一个图案形状的响应.

用于前端工作对抗一个尚未构建的API,或者用于指向某个真实事物而不是静态的光谱文件. : 合同在Spec Fires上测试每个记录端点的真实请求,并验证其已宣布的策略的活性响应.

捕捉到准确的故障模式 API 道克是出名的: 代码移动,道克没有.

爱心型,非零出道 : 已配置 0 一个命令,脚手架 输入文件和线给你。

不再从 README 复制复制. : 少用锅炉板自动插入控制器,所以新生成的文件实际上被接入——每个端点少用一个手动步骤.

打破更改,浮出PR本身,现在运行 spec diff 和帖子打破信息字段更改作为PR评论.

您可以在合并前看到 API 的爆炸半径, 而不是在消费者提交错误文件后看到 。 docfy-mcp:从查询到核查 MCP服务器从引用中取出三种工具,将其转化为代理商的实际QA回路:-旗谱质量问题:缺失摘要/描述,缺失标记,无文件 4xx/5xxx,重复操作ID – 将已装载的目录与另一个光谱(一个文件,一个URL,一个前作的git标签)进行比较,报告打破了信息更改 – 在运行中的服务器上点出真实请求,并验证针对schema的响应,加了一个可重复的Auth,加上一个超时和响应大小的封盖,这样一个运行中的终端点不能将代理商的转弯与/挂起,一个执行客户端的代理现在可以将它将要消耗的光谱显示在它上一个会话上,并测试它自己的整合——所有在编辑器内,没有浏览器圆通.

安全加固同时运出:请求被封顶并装入时间框,通过许可列表而不是默认打开来选择点击任意服务器。

医生,现在使用10种语言 巢道克菲。 com完全本地化——EN,PT,ES,DE,FR,IT,NL,PL,ZH,JA——内容相同,导航相同,自动取自浏览器的地盘.

没有任何关于现有设置的变化——同样的,同样的惯例。

上面的东西都是添加剂 ===== ========================================================================================================================================================================================================================================================= 如果您的 API docs 从现实中漂移, 或者您的代理仍然在猜测您的 API 形状从 stale 注释中, 此释放会关闭两个漏洞 .

分享