dsh-mock-server

Offline OpenAPI-to-mock generators for DeepSeek Harness. Given an OpenAPI 3.x (or Swagger 2.0) document as a JSON string, the plugin's three tools render a runnable Express/Koa stub, plan a route table, and validate the spec. They are pure generators: no network, no subprocess, and no long-running listener is ever started — the produced source is a string you can save and run yourself.

Tools

Tool	Description	Key inputs
mock_fromOpenApi	Render a ready-to-run Express or Koa mock-server stub as a source string, sampling each operation's success response (resolving $ref, allOf, arrays).	schemaJson, framework?, port?, cors?
mock_routes	Plan a flat, normalized route table (method, path, operationId, status) from the document.	jsonSpec
mock_validateSpec	Validate a document for the structural rules the other tools rely on and report every violation in one pass.	specJson

All three return invalid JSON / structural-error details instead of throwing, and mock_fromOpenApi / mock_routes fall back to reported errors when a document is malformed.

Install

npx -y @deepseek-ai/dsh plugin --profile web add @qingshanjiluo/dsh-mock-server

Configuration

Option	Type	Default	Meaning
defaultFramework	string	express	Framework used when a call omits framework (express or koa).
defaultPort	number	3000	Port baked into the generated listen() line when port is omitted.
defaultCors	boolean	true	Whether generated stubs include a permissive CORS layer by default.

Development

npm install --no-audit --no-fund
npx tsc --noEmit      # typecheck
npm run build         # emit lib/index.js and lib/index.d.ts
npx vitest run        # behavior tests
node scripts/load-smoke.mjs   # load the built artifact and register every tool

License

MIT