Repository navigation
Releases
JOONS MCP Mock Server 0.1.0 Preview
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-toolfor 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;
validateandvalidate-fixturescommands.
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