MCP Test Harness Documentation

Documentation Home

Enterprise documentation for MCP Test Harness — the deterministic, CI-native gate for Model Context Protocol servers. Structured like large-platform handbooks: concepts, getting started, how-to guides, and reference.

Current release: 5.3.0 pip install mcp-test-harness==5.3.0

Prefer the Documentation handbook as the single entry point. The README stays a thin index — same pattern as MCP-Bastion Docs.

Testing modes

Use the sticky tabs above (or these cards) to jump between the main CI testing modes.

Load / performance

Latency p90/p95/p99, assert_throughput, assert_load_phases ramps, SLO gates.

Chaos monkey

Protocol-aware faults: delay, 503, truncate, schema drift via @marker.

Resiliency

Reconnect / crash / degrade assertions + mcp-test experiment catalog (RFC-005).

Security testing

Payload packs, Suites A–D, incident E–K, audit verify, agents_md scan, quality_gate, manifest rug-pull, SARIF — CI owns the gate.

CI & reports

HTML dashboard panels, SARIF, PDF export, sample scan report.

Sample scan report

Interactive HTML artifact — gate scorecard, chaos/load/security panels.

Start here

Documentation handbook

Visual tour, security-first rationale, CI scan report, feature map, operate recipes, Bastion pairing.

Getting started

Install → mcp-test init → first green run in minutes.

Examples / demos

Feature demos for functional, regression, performance, and security.

Multi-language suite

Java · Node · Go · .NET adapters via mcp-test-suite — package download links.

Bastion runtime handbook

Companion product: enforce in production what CI verified.

Learning paths

Developer (minutes): Getting started → Examples → Developer guide
Security reviewer: Handbook → Security → Bastion runtime handbook
Platform / perf: Load / performance → Stateless tutorial → Docker
Resiliency: Chaos → Resiliency → experiment suite
Compliance: CRA & SBOM → Enterprise governance → scan report evidence

Scan → Test → Enforce

Scan / config (mcp-shark, Bastion scan)
        →  Test / CI gate (MCP Test Harness)
        →  Enforce / runtime (MCP-Bastion)