name: Conformance on: push: branches: [main] pull_request: branches: [main] workflow_dispatch: concurrency: group: conformance-${{ github.ref }} cancel-in-progress: true env: # Pinned for reproducible runs; bump deliberately when the suite updates. CONFORMANCE_VERSION: "0.1.16" # When updating DRAFT_CONFORMANCE_VERSION, diff # `conformance list --spec-version 2026-07-28` # and update #977 DRAFT_CONFORMANCE_VERSION: "0.2.0-alpha.9" jobs: server: runs-on: ubuntu-latest timeout-minutes: 10 permissions: contents: read steps: - uses: actions/checkout@v7 - name: Install Rust toolchain uses: dtolnay/rust-toolchain@stable - uses: Swatinem/rust-cache@v2 # Build the whole package (server + client bins): the conformance crate is # excluded from the workspace default-members. - name: Build conformance binaries run: cargo build -p mcp-conformance - name: Test conformance server run: cargo test -p mcp-conformance --bin conformance-server - name: Start 2025-11-25 server run: | PORT=8001 ./target/debug/conformance-server & echo $! > server.pid for _ in $(seq 1 30); do if curl -s -o /dev/null http://127.0.0.1:8001/mcp; then exit 0 fi sleep 1 done echo "conformance server did not become ready" >&2 exit 1 - name: Run 2025-11-25 server suite run: | npx -y "@modelcontextprotocol/conformance@${CONFORMANCE_VERSION}" server \ --url http://127.0.0.1:8001/mcp \ --spec-version 2025-11-25 \ -o conformance-results # These pass today but are excluded from the default "active" suite; # run them explicitly so regressions are still caught. - name: Run 2025-11-25 pending scenarios run: | for scenario in json-schema-2020-12 server-sse-polling; do npx -y "@modelcontextprotocol/conformance@${CONFORMANCE_VERSION}" server \ --url http://127.0.0.1:8001/mcp \ --scenario "$scenario" \ -o conformance-results done - name: Start draft server run: | STATELESS=1 PORT=8002 ./target/debug/conformance-server & echo $! > draft-server.pid for _ in $(seq 1 30); do if curl -s -o /dev/null http://127.0.0.1:8002/mcp; then exit 0 fi sleep 1 done echo "draft conformance server did not become ready" >&2 exit 1 - name: Run 2026-07-28 versioned-spec server suite run: | npx -y "@modelcontextprotocol/conformance@${DRAFT_CONFORMANCE_VERSION}" server \ --url http://127.0.0.1:8002/mcp \ --suite all \ --spec-version 2026-07-28 \ -o conformance-results # Extension scenarios are excluded by the --spec-version filter and # are informational for tiering. Run them explicitly so their gaps remain # visible and newly passing scenarios make the strict baseline fail stale. - name: Run Tasks extension server suite (informational) run: | scenarios=( tasks-lifecycle tasks-capability-negotiation tasks-wire-fields tasks-request-state-removal tasks-mrtr-input tasks-request-headers tasks-dispatch-and-envelope tasks-status-notifications tasks-required-task-error tasks-mrtr-composition ) for scenario in "${scenarios[@]}"; do npx -y "@modelcontextprotocol/conformance@${DRAFT_CONFORMANCE_VERSION}" server \ --url http://127.0.0.1:8002/mcp \ --scenario "$scenario" \ --expected-failures conformance/expected-failures-extensions.yaml \ -o conformance-extension-results done - name: Stop conformance servers if: always() run: | kill "$(cat draft-server.pid)" 2>/dev/null || true kill "$(cat server.pid)" 2>/dev/null || true - name: Upload results if: always() uses: actions/upload-artifact@v7 with: name: conformance-server-results path: | conformance-results conformance-extension-results client: runs-on: ubuntu-latest timeout-minutes: 10 permissions: contents: read steps: - uses: actions/checkout@v7 - name: Install Rust toolchain uses: dtolnay/rust-toolchain@stable - uses: Swatinem/rust-cache@v2 - name: Build conformance binaries run: cargo build -p mcp-conformance - name: Run 2025-11-25 client suite run: | npx -y "@modelcontextprotocol/conformance@${CONFORMANCE_VERSION}" client \ --command "$(pwd)/target/debug/conformance-client" \ --suite all \ --spec-version 2025-11-25 \ -o conformance-client-results/full - name: Run 2026-07-28 versioned-spec client suite run: | npx -y "@modelcontextprotocol/conformance@${DRAFT_CONFORMANCE_VERSION}" client \ --command "$(pwd)/target/debug/conformance-client" \ --suite all \ --spec-version 2026-07-28 \ -o conformance-client-results/draft - name: Run extension client suite (informational) run: | npx -y "@modelcontextprotocol/conformance@${DRAFT_CONFORMANCE_VERSION}" client \ --command "$(pwd)/target/debug/conformance-client" \ --suite extensions \ --expected-failures conformance/expected-failures-extensions.yaml \ -o conformance-client-results/extensions - name: Upload results if: always() uses: actions/upload-artifact@v7 with: name: conformance-client-results path: conformance-client-results