From ce4d44322bae878fe41a4dab60e2635e805094d6 Mon Sep 17 00:00:00 2001 From: matteoroxis Date: Mon, 30 Mar 2026 16:58:58 +0200 Subject: [PATCH 1/4] docs: add conformance summary to README --- README.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/README.md b/README.md index 34133a796..b5ba1b85d 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,32 @@ To run the tests you have to pre-install `Docker` and `npx`. ```bash ./mvnw test ``` +### Conformance Tests + +The SDK is validated against the [MCP conformance test suite](https://github.com/modelcontextprotocol/conformance). +Full details and instructions are in [`conformance-tests/VALIDATION_RESULTS.md`](conformance-tests/VALIDATION_RESULTS.md). + +**Latest results:** + +| Suite | Result | +|---------------|------------------------------------------------| +| Server | ✅ 40/40 passed (100%) | +| Client | ⚠️ 3/4 scenarios, 9/10 checks passed | +| Auth (Spring) | ⚠️ 12/14 scenarios fully passing (98.9% checks) | + +To run the conformance tests locally you need `npx` installed. + +```bash +# Server conformance +./mvnw compile -pl conformance-tests/server-servlet -am exec:java +npx @modelcontextprotocol/conformance server --url http://localhost:8080/mcp --suite active + +# Client conformance +./mvnw clean package -DskipTests -pl conformance-tests/client-jdk-http-client -am +npx @modelcontextprotocol/conformance client \ + --command "java -jar conformance-tests/client-jdk-http-client/target/client-jdk-http-client-1.1.0-SNAPSHOT.jar" \ + --scenario initialize +``` ## Contributing From 3a7818201e68353ee322e88748425de5643532b4 Mon Sep 17 00:00:00 2001 From: Sergei Semenov Date: Wed, 1 Apr 2026 08:55:33 -0700 Subject: [PATCH 2/4] Fixed URL links from README.md to 'Java Dependencies', 'Java MCP Client', 'Java MCP Server' pages (#874) --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 34133a796..a1206adc5 100644 --- a/README.md +++ b/README.md @@ -15,9 +15,9 @@ For comprehensive guides and SDK API documentation - [Features](https://modelcontextprotocol.github.io/java-sdk/#features) - Overview the features provided by the Java MCP SDK - [Architecture](https://modelcontextprotocol.github.io/java-sdk/#architecture) - Java MCP SDK architecture overview. -- [Java Dependencies / BOM](https://modelcontextprotocol.github.io/java-sdk/quickstart/#dependencies) - Java dependencies and BOM. -- [Java MCP Client](https://modelcontextprotocol.github.io/java-sdk/client/) - Learn how to use the MCP client to interact with MCP servers. -- [Java MCP Server](https://modelcontextprotocol.github.io/java-sdk/server/) - Learn how to implement and configure a MCP servers. +- [Java Dependencies / BOM](https://java.sdk.modelcontextprotocol.io/latest/quickstart/#dependencies) - Java dependencies and BOM. +- [Java MCP Client](https://java.sdk.modelcontextprotocol.io/latest/client/) - Learn how to use the MCP client to interact with MCP servers. +- [Java MCP Server](https://java.sdk.modelcontextprotocol.io/latest/server/) - Learn how to implement and configure a MCP servers. #### Spring AI MCP documentation [Spring AI MCP](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-overview.html) extends the MCP Java SDK with Spring Boot integration, providing both [client](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and [server](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-server-boot-starter-docs.html) starters. From 03e61a3b73ea810cf3e4ff7265912691e84f1f5c Mon Sep 17 00:00:00 2001 From: matteoroxis Date: Mon, 30 Mar 2026 16:58:58 +0200 Subject: [PATCH 3/4] docs: add conformance summary to README --- README.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/README.md b/README.md index a1206adc5..46c429e98 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,32 @@ To run the tests you have to pre-install `Docker` and `npx`. ```bash ./mvnw test ``` +### Conformance Tests + +The SDK is validated against the [MCP conformance test suite](https://github.com/modelcontextprotocol/conformance). +Full details and instructions are in [`conformance-tests/VALIDATION_RESULTS.md`](conformance-tests/VALIDATION_RESULTS.md). + +**Latest results:** + +| Suite | Result | +|---------------|------------------------------------------------| +| Server | ✅ 40/40 passed (100%) | +| Client | ⚠️ 3/4 scenarios, 9/10 checks passed | +| Auth (Spring) | ⚠️ 12/14 scenarios fully passing (98.9% checks) | + +To run the conformance tests locally you need `npx` installed. + +```bash +# Server conformance +./mvnw compile -pl conformance-tests/server-servlet -am exec:java +npx @modelcontextprotocol/conformance server --url http://localhost:8080/mcp --suite active + +# Client conformance +./mvnw clean package -DskipTests -pl conformance-tests/client-jdk-http-client -am +npx @modelcontextprotocol/conformance client \ + --command "java -jar conformance-tests/client-jdk-http-client/target/client-jdk-http-client-1.1.0-SNAPSHOT.jar" \ + --scenario initialize +``` ## Contributing From 384c1c8b9be28e44d359153f333e9a666bc16ae0 Mon Sep 17 00:00:00 2001 From: matteoroxis Date: Wed, 1 Apr 2026 18:16:30 +0200 Subject: [PATCH 4/4] docs: add conformance summary to README --- README.md | 27 ++++++++++++++++++--------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 46c429e98..4873876a6 100644 --- a/README.md +++ b/README.md @@ -42,16 +42,16 @@ To run the tests you have to pre-install `Docker` and `npx`. ``` ### Conformance Tests -The SDK is validated against the [MCP conformance test suite](https://github.com/modelcontextprotocol/conformance). +The SDK is validated against the [MCP conformance test suite](https://github.com/modelcontextprotocol/conformance) at 0.1.15 version. Full details and instructions are in [`conformance-tests/VALIDATION_RESULTS.md`](conformance-tests/VALIDATION_RESULTS.md). **Latest results:** -| Suite | Result | -|---------------|------------------------------------------------| -| Server | ✅ 40/40 passed (100%) | -| Client | ⚠️ 3/4 scenarios, 9/10 checks passed | -| Auth (Spring) | ⚠️ 12/14 scenarios fully passing (98.9% checks) | +| Suite | Result | +|---------------|-----------------------------------------------------| +| Server | ✅ 40/40 passed (100%) | +| Client | 🟡 3/4 scenarios, 9/10 checks passed | +| Auth (Spring) | 🟡 12/14 scenarios fully passing (98.9% checks) | To run the conformance tests locally you need `npx` installed. @@ -62,9 +62,18 @@ npx @modelcontextprotocol/conformance server --url http://localhost:8080/mcp --s # Client conformance ./mvnw clean package -DskipTests -pl conformance-tests/client-jdk-http-client -am -npx @modelcontextprotocol/conformance client \ - --command "java -jar conformance-tests/client-jdk-http-client/target/client-jdk-http-client-1.1.0-SNAPSHOT.jar" \ - --scenario initialize +for scenario in initialize tools_call elicitation-sep1034-client-defaults sse-retry; do + npx @modelcontextprotocol/conformance client \ + --command "java -jar conformance-tests/client-jdk-http-client/target/client-jdk-http-client-2.0.0-SNAPSHOT.jar" \ + --scenario $scenario +done + +# Auth conformance (Spring HTTP Client) +./mvnw clean package -DskipTests -pl conformance-tests/client-spring-http-client -am +npx @modelcontextprotocol/conformance@0.1.15 client \ + --spec-version 2025-11-25 \ + --command "java -jar conformance-tests/client-spring-http-client/target/client-spring-http-client-2.0.0-SNAPSHOT.jar" \ + --suite auth ``` ## Contributing