Spec-Forge:零配置 OpenAPI mock 服务器,支持严格校验与 MCP stdio
Spec-Forge – Zero-config OpenAPI mock server with strict validation&MCP stdio
Spec-Forge 是一款零配置 OpenAPI mock 服务器,通过 MCP stdio 为 Claude、Cursor、Windsurf 等 AI 编码智能体提供 6 个标准工具,用于发现端点、解析 $ref schema、生成 mock 数据、校验契约和模拟 400/422/500 等错误。
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