Package org.mockserver.netty.mcp

Class McpContractTest

java.lang.Object

org.mockserver.netty.mcp.McpContractTest

public class McpContractTest
extends Object

Deterministic conformance / contract tester for a target MCP (Model Context Protocol) server reachable over Streamable HTTP.

It exercises the required JSON-RPC handshake and core methods — initialize, notifications/initialized, ping, tools/list, unknown-method rejection, and optionally a single tools/call — and reports per-check conformance.

This validates only the shape of responses (the JSON-RPC 2.0 envelope and the required result fields of each method), never the semantics of any tool. No LLM and no MockServer state are involved, so the outcome is fully deterministic.

The HTTP transport is injected as a McpContractTest.JsonRpcExchange so the orchestration is unit testable without a network, mirroring org.mockserver.openapi.OpenApiContractTest.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	McpContractTest.CheckResult	Outcome of a single named conformance check.
static class	McpContractTest.ExchangeResult	Result of a single JSON-RPC exchange.
static interface	McpContractTest.JsonRpcExchange	One JSON-RPC exchange against the target server.
static class	McpContractTest.Report	Full conformance report.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_PROTOCOL_VERSION	Default MCP protocol version advertised by the client when the caller supplies none.

Constructor Summary

Constructors

Constructor	Description
McpContractTest(com.fasterxml.jackson.databind.ObjectMapper mapper)

Method Summary

Modifier and Type	Method	Description
McpContractTest.Report	run(String protocolVersion, String toolName, McpContractTest.JsonRpcExchange exchange)	Run the conformance suite against the target server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT_PROTOCOL_VERSION

public static final String DEFAULT_PROTOCOL_VERSION

Default MCP protocol version advertised by the client when the caller supplies none. Corresponds to the 2025-03-26 MCP specification; callers can override it via the protocolVersion argument to test a server against a newer or older revision.

See Also:

• Constant Field Values

Constructor Details

McpContractTest

public McpContractTest(com.fasterxml.jackson.databind.ObjectMapper mapper)

Method Details

run

public McpContractTest.Report run(String protocolVersion,
 String toolName,
 McpContractTest.JsonRpcExchange exchange)

Run the conformance suite against the target server.

Parameters:

protocolVersion - protocol version to advertise (null/blank → DEFAULT_PROTOCOL_VERSION)

toolName - optional tool to exercise via a tools/call shape check (null/blank → skipped)

exchange - the JSON-RPC transport

Returns:

the conformance report