docs: add conformance summary to README

Signed-off-by: Daniel Garnier-Moiroux <git@garnier.wf>
This commit is contained in:
matteoroxis 2026-03-30 16:58:58 +02:00 • committed by Daniel Garnier-Moiroux
commit b6eb672c19

View file

@ -40,6 +40,41 @@ 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) 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) |
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
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