Skip to content
MCP Lab

Getting Started

MCP Failure Lab requires Node.js 22.19.0 or newer and npm. The fastest path needs no clone or global install:

Terminal window
npx mcp-failure-lab demo

The demo runs a real deterministic 500ms delay through the built-in client, in-memory transport, server, delay tool, and assertion pipeline.

Explore the CLI

Section titled “Explore the CLI”
Terminal window
npx mcp-failure-lab --help
npx mcp-failure-lab --version

Start the stdio server

Section titled “Start the stdio server”
Terminal window
npx mcp-failure-lab serve

The process waits silently for a client. Protocol messages use stdout, so operational diagnostics are written to stderr. Press Ctrl+C for graceful shutdown.

Run an included scenario

Section titled “Run an included scenario”

From a repository checkout:

Terminal window
git clone https://github.com/anilloutombam/mcp-failure-lab.git
cd mcp-failure-lab
npm install
npm run dev -- run examples/scenarios/delay-success.json

Next: learn the scenario format.