Features deck · v4.0.1

MCP Test Harness

The pytest-style testing framework for MCP servers — functional, regression, and performance in one CI-native tool.

  • 1080+ tests · 100% library coverage gate
  • 23 PyPI packages + GHCR Docker + GitHub Action
  • MIT licensed · no LLM required

The problem

MCP Inspector doesn't belong in CI

Exploration is manual. Production needs deterministic, repeatable, code-first tests on every push — with JUnit, SARIF, and HTML evidence.

End-to-end MCP test flow

Three modes

Functional · Regression · Performance

Functional

assert_tool_call, assert_capabilities, assert_tool_schema, protocol version gates

Regression

assert_snapshot, mask_patterns, assert_tool_idempotent — catch silent drift

Performance

assert_latency p95/p99, assert_throughput, SLO gates in CI

Three testing modes

Productivity

Record → Generate → Gate

Record

mcp-test record — live MCP calls become tests + snapshots (RFC-001)

Generate

mcp-test generate — scaffold suites from tool definitions

Gate

pre-commit hook, GitHub Action, conformance badge, SARIF export

Developer journey

Reports

Console · JUnit · JSON · HTML · PDF

Self-contained HTML dashboard with charts, chaos panels, MCP trace timeline, security findings, and PDF export via Save as PDF or mcp-test export-pdf.

Open sample report
HTML dashboard

Resiliency & security

Chaos · Experiments · SARIF · Bastion pairing

Chaos testing

@marker chaos_faults — delay, 503, truncate, schema drift

Experiment catalog

mcp-test experiment run --suite core with scorecards

Security packs

assert_tool_denied, authorization boundaries, OWASP MCP SARIF

MCP-Bastion

Test defenses in CI; enforce at runtime in production

Harness and Bastion pairing

Distribution

18 PyPI wheels · Docker · Binary · Action

Core harness plus 17 framework shims. GHCR runtime and dev images. PyInstaller binary. Marketplace composite action with PR comments.

pip install mcp-test-harness==4.0.1 docker pull ghcr.io/vaquarkhan/mcp-test-harness:latest
All 23 packages →

Get started in 5 minutes

pip install mcp-test-harnessmcp-test init → write test_*.pymcp-test