Repository navigation
JOONS MCP Mock Server 0.1.0 Preview
Pre-releaseJOONS 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