scripts: add conformance test runner (#694)

Add a script to run the official MCP conformance tests against the SDK's
conformance server. The script supports saving results to a custom
directory (--result_dir) and running against a local checkout of the
conformance repo (--conformance_repo).

Document the script in CONTRIBUTING.md.

For #650
This commit is contained in:
Robert Findley 2025-12-08 13:03:17 -05:00 • committed by GitHub
commit 6c16aa60a6
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -26,6 +26,34 @@ containing the SDK, run:
go work init ./project ./go-sdk
```
### Conformance tests
The SDK includes a script to run the official MCP conformance tests against the
SDK's conformance server:
```sh
./scripts/conformance.sh
```
By default, results are cleaned up after the script runs. To save results to a
specific directory:
```sh
./scripts/conformance.sh --result_dir ./conformance-results
```
To run against a local checkout of the
[conformance repo](https://github.com/modelcontextprotocol/conformance) instead
of the latest npm release:
```sh
./scripts/conformance.sh --conformance_repo ~/src/conformance
```
Note: you must run `npm install` in the conformance repo first.
Run `./scripts/conformance.sh --help` for more options.
## Filing issues
This project uses the [GitHub issue