Docs / Multi-language suite

Multi-language suite

MCP Test Harness (this repo) is the Python test engine on PyPI — assertions, transports, HTML dashboard, reports.

mcp-test-suite is the multi-language connector layer: shared mcp-suite.yaml, adapters for Node / Java / Go / .NET, Docker, and a GitHub Action. It does not vendor harness source; the engine always comes from PyPI.

Same pattern as Bastion → mcp-bastion-suite. Deep language tutorials live in the suite so this README stays light. This page is the bridge.

How the two repos relate

┌─────────────────────────────────────────────────────────┐
│  Your app (Nest, Spring, FastAPI, .NET, Go, Rust, …)    │
└───────────────────────────┬─────────────────────────────┘
                            │
              ┌─────────────▼─────────────┐
              │  mcp-test-suite           │
              │  adapters · YAML · Action │
              │  github.com/…/mcp-test-suite
              └─────────────┬─────────────┘
                            │  mcp-suite.yaml
                            ▼
              ┌───────────────────────────────────────┐
              │  mcp-test-harness (this project)      │
              │  assertions · reports · CI gate       │
              │  pip install mcp-test-harness         │
              └───────────────────────────────────────┘

Repo	Role
mcp-test-harness	Engine + Python pytest API + docs site + PyPI ecosystem shims
mcp-test-suite	Connectors for every language / framework

Package downloads (suite v4.0.0)

Python / PyPI · Java / Maven · Node / npm · Go module · .NET / NuGet · Release assets · Install guide

Install matrix

You use	Install
Python engine / CLI	`pip install mcp-test-harness`
Suite CLI (`mcp-suite`)	`pip install "git+https://github.com/vaquarkhan/mcp-test-suite.git"`
Java / Kotlin	Maven GitHub Packages `io.github.vaquarkhan:mcp-test-suite-junit5:4.0.0` · package
Node / TypeScript	`npm install -D @vaquarkhan/mcp-test-suite-jest` (GitHub Packages) · package
Go	`go get github.com/vaquarkhan/mcp-test-suite/adapters/gotest@v4.0.0`
.NET	NuGet GitHub Packages `McpTestSuite.Xunit` · package
Any / CI	GitHub Action · Release assets · Docker in suite repo

GitHub Packages installs need a PAT with read:packages. Direct JAR / .tgz / .nupkg from Release v4.0.0 do not.

Language support

Language	Package	Suite tutorial
Any (YAML)	`mcp-suite`	yaml.md
Python	`mcp-test-harness`	python.md
TypeScript	`@vaquarkhan/mcp-test-suite-jest`	typescript.md
Java / Kotlin	`mcp-test-suite-junit5`	java.md
Go	`adapters/gotest`	go.md
.NET	`McpTestSuite.Xunit`	dotnet.md
Rust	YAML + CLI	rust.md

Where to go next

Suite DOWNLOADS.md — full install commands
MULTI_LANGUAGE.md — architecture
Python framework integrations — OpenAI, LangChain, FastMCP, … + ecosystem download totals
Getting started — Python-first path in this repo