Skip to content

Releases

JOONS MCP Mock Server 0.1.0 Preview

Pre-release

Choose a tag to compare

@dbdefault dbdefault released this 12 Nov 11:57

JOONS MCP Mock Server 0.1.0 is the first Preview release.

Create realistic mock MCP servers from tool snapshots for safe agent development and testing. It reads a tool snapshot (the joons-mcp-diff snapshot format, schemaVersion 1) and an optional JSON fixture file, and serves a MOCK MCP server over stdio that real MCP clients can connect to.

Safety first: no real actions are ever performed. No network requests, no file changes except the optional report you choose, no child processes, no forwarding to a real server, and nothing from snapshots, fixtures or arguments is executed.

Highlights

  • Official MCP SDK server over stdio: initialize, ping, tools/list, tools/call; serverInfo and startup banner are clearly marked MOCK.
  • Fixture responses: default, first-match on arguments, named scenarios; text, image, audio, structuredContent, isError, protocol errors with exact messages, delays.
  • Built-in scenarios default, empty, error, slow, server-error; --fail-tool for single-tool failures. Deterministic: the same calls give the same results.
  • Argument validation for a JSON Schema subset; unknown tools return a protocol error.
  • In-memory call recording with masking of secret-looking arguments and an optional JSON report.
  • Limits for input size, depth, tool count, response size, concurrency and time; strict fixture validation; validate and validate-fixtures commands.

Not in 0.1.0: Streamable HTTP, resources, prompts, pagination. Formats may change before 1.0. Not published to npm.

Install: npm install -g github:dbdefault/joons-mcp-mock-server#v0.1.0