跳到正文
Hacker News· gorlak-town·· 9 天前AI 评分34

Spec-Forge:零配置 OpenAPI mock 服务器,支持严格校验与 MCP stdio

Spec-Forge – Zero-config OpenAPI mock server with strict validation&MCP stdio

AI 导读

Spec-Forge 是一款零配置 OpenAPI mock 服务器,通过 MCP stdio 为 Claude、Cursor、Windsurf 等 AI 编码智能体提供 6 个标准工具,用于发现端点、解析 $ref schema、生成 mock 数据、校验契约和模拟 400/422/500 等错误。

正文 · AI 翻译

Gorlak Town Venture #1 • 双引擎:AI 智能体(MCP)+ 人类开发者

为自主 AI 编码智能体(Claude、Cursor、Windsurf)配备原生 Model Context Protocol (MCP) 工具,以模拟 API、验证契约并生成测试夹具——同时为人类团队提供超快 CLI 和交互式 Web 演练场。

Model Context Protocol (MCP) 服务器

以原生 OpenAPI 工具为编码智能体提供依据

阻止 AI 智能体幻觉出请求体或破坏下游 API。spec-forge mcp run ./spec.yaml 为 Claude、Cursor 和 Windsurf 配备 6 个标准 MCP 工具:

list_endpoints 发现所有路由与标签

inspect_endpoint 深度解析 $ref 的 schema

mock_request 即时生成逼真的模拟数据

validate_contract 预检 schema 校验

generate_fixture 合成单元测试夹具

simulate_failure 边界情况(400、422、500)

$ spec-forge mcp run ./api-spec.yaml 支持 stdio 与 SSE

零配置开发者 CLI 与演练场

3 秒内启动本地 OpenAPI 模拟

交互式演示 ↓

无需创建账户或支付月度席位费,即可运行独立的本地模拟服务器。完整的 OpenAPI 3.0/3.1 校验,支持模拟延迟和运行时错误注入。

$ spec-forge serve ./api-spec.yaml --strict --latency 150

私有测试版 申请云端与 CI 早期访问 142 名申请者

率先测试 spec-forge 0.2 托管模拟端点、团队工作区和自动 PR 契约检查。

🔒 零垃圾邮件。随时可退订。申请邀请即表示您同意我们的 隐私政策。

✔ 已申请测试版邀请!您已进入优先等候名单。

您的邀请码: • 排名:

✔ 兼容 OpenAPI 3.0 与 3.1

⚡ 递归 $ref 解析

🛡️ 严格模式 HTTP 422 拒绝

🎛️ 状态码覆盖(?__status=404)

Model Context Protocol (MCP) 标准

自主编码智能体不应幻觉出 API 载荷或猜测响应结构。spec-forge 可将任何 OpenAPI schema 转换为适用于 Claude Desktop、Cursor、Windsurf 和自定义智能体集群的活跃 MCP 服务器。

🧭

零幻觉依据

智能体调用 list_endpoints 和 inspect_endpoint 来发现参数、递归 $ref 模型和 HTTP 响应码,然后再生成客户端代码。

🛡️

预检契约校验

智能体在编写测试前用 validate_contract 测试其 JSON 载荷。针对缺失属性、枚举不匹配和正则失败返回精确的字段级诊断信息。

🧪

合成夹具生成

Agents 执行 generate_fixture 和 simulate_failure 以生成逼真的示例模拟负载,并自动验证错误路径(400、401、404、422、500)。

🎬 产品演示与在线演练场

观看自动化演示视频,或测试根据我们的 OpenAPI 契约生成的实时模拟响应。

Stoplight Prism 很笨重,每月要花 35 美元。json-server 不检查类型。spec-forge 让你兼得两者之长。

功能 / 能力 ⚡ spec-forge Stoplight Prism json-server
定价模式 $19 一次性买断(终身) $35 / 月 / 席位 免费(无人维护)
OpenAPI 3.1 与 3.0 支持 完整(支持递归 $ref) 部分 / 侧重 3.0 无(手动 JSON)
严格契约模式(HTTP 422) ✔ 即时 422 拒绝 仅警告 无
启动时间 < 0.2 秒 2 - 5 秒(笨重的 Node) 0.5 秒
智能数据合成 自动 UUID、Email、Date、Bounds 基础 schema 伪造器 静态硬编码值
状态码覆盖请求头 ?__status=... 或 X-Mock-Status 有限的查询参数 不支持
Python / ASGI 嵌入 create_mock_app(spec) 否(仅 CLI / Node) 否(仅 Express)

🚀

零配置

无需播种数据库,无需维护伪造脚本。将 spec-forge serve 指向你的规范,即可获得匹配每种方法和状态码的即时模拟路由。

🛡️

严格契约测试

在本地开发或 CI 流水线中启用 --strict。如果你的前端传入了错误的类型或遗漏了必填字段,spec-forge 会快速失败并给出确切的详细信息。

🎲

智能数据合成

自动合成格式感知的字符串(UUID、date-time、email、URI),强制执行数值边界(min/max),并解析嵌套的 $ref schema,且不会出现循环错误。

本地开发无需每月经常性订阅费用。一次付费,永久拥有。

工程团队

面向初创公司、软件工作室和工程团队。

$49 / 终身许可证

  • ✔ 团队级 MCP 配置与 CI/CD agent 门禁
  • ✔ 最多 10 个工程师开发者席位
  • ✔ Docker 与 CI/CD 流水线集成脚本
  • ✔ 包含所有 Solo Developer 与 MCP 功能
  • ✔ 优先 GitHub issue 响应

来源:Hacker News · spec-forge.dev2share.com