Skip to content

Commit b6eb672

Browse files
matteoroxisKehrlann
authored andcommitted
docs: add conformance summary to README
Signed-off-by: Daniel Garnier-Moiroux <git@garnier.wf>
1 parent 3a78182 commit b6eb672

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,41 @@ To run the tests you have to pre-install `Docker` and `npx`.
4040
```bash
4141
./mvnw test
4242
```
43+
### Conformance Tests
44+
45+
The SDK is validated against the [MCP conformance test suite](https://github.com/modelcontextprotocol/conformance) at 0.1.15 version.
46+
Full details and instructions are in [`conformance-tests/VALIDATION_RESULTS.md`](conformance-tests/VALIDATION_RESULTS.md).
47+
48+
**Latest results:**
49+
50+
| Suite | Result |
51+
|---------------|-----------------------------------------------------|
52+
| Server | ✅ 40/40 passed (100%) |
53+
| Client | 🟡 3/4 scenarios, 9/10 checks passed |
54+
| Auth (Spring) | 🟡 12/14 scenarios fully passing (98.9% checks) |
55+
56+
To run the conformance tests locally you need `npx` installed.
57+
58+
```bash
59+
# Server conformance
60+
./mvnw compile -pl conformance-tests/server-servlet -am exec:java
61+
npx @modelcontextprotocol/conformance server --url http://localhost:8080/mcp --suite active
62+
63+
# Client conformance
64+
./mvnw clean package -DskipTests -pl conformance-tests/client-jdk-http-client -am
65+
for scenario in initialize tools_call elicitation-sep1034-client-defaults sse-retry; do
66+
npx @modelcontextprotocol/conformance client \
67+
--command "java -jar conformance-tests/client-jdk-http-client/target/client-jdk-http-client-2.0.0-SNAPSHOT.jar" \
68+
--scenario $scenario
69+
done
70+
71+
# Auth conformance (Spring HTTP Client)
72+
./mvnw clean package -DskipTests -pl conformance-tests/client-spring-http-client -am
73+
npx @modelcontextprotocol/conformance@0.1.15 client \
74+
--spec-version 2025-11-25 \
75+
--command "java -jar conformance-tests/client-spring-http-client/target/client-spring-http-client-2.0.0-SNAPSHOT.jar" \
76+
--suite auth
77+
```
4378

4479
## Contributing
4580

0 commit comments

Comments
 (0)