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 • Dual-Engine: AI Agents (MCP) + Human Developers
Equip autonomous AI coding agents (Claude, Cursor, Windsurf) with native Model Context Protocol (MCP) tools to mock APIs, validate contracts, and generate fixtures — while providing human teams an ultra-fast CLI and interactive web playground.
Model Context Protocol (MCP) Server
Ground Coding Agents with Native OpenAPI Tools
Stop AI agents from hallucinating request bodies or breaking downstream APIs. spec-forge mcp run ./spec.yaml equips Claude, Cursor, and Windsurf with 6 standard MCP tools:
list_endpoints Discover all routes & tags
inspect_endpoint Deep $ref resolved schemas
mock_request Instant realistic mock data
validate_contract Pre-flight schema checking
generate_fixture Synthetic unit test fixtures
simulate_failure Edge cases (400, 422, 500)
$ spec-forge mcp run ./api-spec.yaml stdio & SSE supported
Zero-Config Developer CLI & Playground
Spin Up Local OpenAPI Mocks in 3 Seconds
Run standalone local mock servers without account creation or monthly seat fees. Full OpenAPI 3.0/3.1 validation with simulated latency and runtime error injection.
$ spec-forge serve ./api-spec.yaml --strict --latency 150
Private Beta Request Cloud & CI Early Access 142 applicants
Be the first to test spec-forge 0.2 hosted mock endpoints, team workspaces, and automatic PR contract checks.
🔒 Zero spam. Unsubscribe anytime. By requesting an invite, you agree to our Privacy Policy.
✔ Beta invite requested! You're on the priority waitlist.
Your invite code: • Position:
✔ OpenAPI 3.0 & 3.1 Compliant
⚡ Recursive $ref Resolution
🛡️ Strict Mode HTTP 422 Rejection
🎛️ Status Override (?__status=404)
Model Context Protocol (MCP) Standard
Autonomous coding agents shouldn't hallucinate API payloads or guess response structures. spec-forge turns any OpenAPI schema into an active MCP server for Claude Desktop, Cursor, Windsurf, and custom agent swarms.
🧭
Zero-Hallucination Grounding
Agents call list_endpoints and inspect_endpoint to discover parameters, recursive $ref models, and HTTP response codes before generating client code.
🛡️
Pre-Flight Contract Validation
Agents test their JSON payloads with validate_contract before writing tests. Returns exact field-level diagnostics for missing properties, enum mismatches, and regex failures.
🧪
Synthetic Fixture Synthesis
Agents execute generate_fixture and simulate_failure to produce realistic sample mock payloads and verify error paths (400, 401, 404, 422, 500) automatically.
🎬 Product Demo & Live Playground
Watch the automated walkthrough video or test live mock responses generated from our OpenAPI contract.
Stoplight Prism is heavy and costs $35/month. json-server doesn't check types. spec-forge gives you the best of both worlds.
| Feature / Capability | ⚡ spec-forge | Stoplight Prism | json-server |
|---|---|---|---|
| Pricing Model | $19 One-Time (Lifetime) | $35 / month / seat | Free (Unmaintained) |
| OpenAPI 3.1 & 3.0 Support | Full (with recursive $ref) | Partial / 3.0 focused | None (Manual JSON) |
| Strict Contract Mode (HTTP 422) | ✔ Instant 422 Rejection | Warnings only | None |
| Startup Time | < 0.2 seconds | 2 - 5 seconds (heavy Node) | 0.5 seconds |
| Intelligent Data Synthesis | Auto UUID, Email, Date, Bounds | Basic schema faker | Static hardcoded values |
| Status Code Override Header | ?__status=... or X-Mock-Status | Limited query params | Not supported |
| Python / ASGI Embedding | create_mock_app(spec) | No (CLI / Node only) | No (Express only) |
🚀
Zero Configuration
No database to seed, no faker scripts to maintain. Point spec-forge serve at your spec and get instant mock routes matching every method and status code.
🛡️
Strict Contract Tests
Enable --strict in your local development or CI pipeline. If your frontend passes the wrong type or forgets a required field, spec-forge fails fast with exact details.
🎲
Smart Data Synthesis
Automatically synthesizes format-aware strings (UUID, date-time, email, URI), enforces numeric bounds (min/max), and resolves nested $ref schemas without cycle bugs.
No monthly recurring subscription fees for local development. Pay once, own it forever.
Engineering Team
For startups, software studios, and engineering teams.
$49 / lifetime license
- ✔ Team-Wide MCP Configurations & CI/CD agent gates
- ✔ Up to 10 engineer developer seats
- ✔ Docker & CI/CD pipeline integration scripts
- ✔ All Solo Developer & MCP features included
- ✔ Priority GitHub issue response
来源：Hacker News · spec-forge.dev2share.com