mcp-chaos-rig

The mcp-chaos-rig is a local Model Context Protocol (MCP) server designed to simulate various failure scenarios for your client applications. By breaking on demand, it allows developers to test their software against challenges such as authentication failures, tool disappearances, flaky responses, and token expiry—all through an intuitive web UI. This tool is essential for ensuring robust error handling and resilience in your applications.

Once you have connected to the mcp-chaos-rig server, you can easily trigger different failure scenarios from the web interface. You can simulate authentication failures by requesting invalid tokens, or test how your application handles tool disappearances by randomly removing tools during operation. Using the available commands, you can also initiate flaky responses to assess your client’s error management capabilities. For best results, try running a series of tests with varying configurations to thoroughly evaluate your application’s robustness.

Prerequisites

• Ensure you have Node.js installed on your machine (version 14.x or higher recommended).

Option A: Quick start with npx

You can quickly start the mcp-chaos-rig server using the following command:

npx -y mcp-chaos-rig

Option B: Global install alternative

Alternatively, you can install it globally on your system with:

npm install -g mcp-chaos-rig

After installation, you can start the server with:

mcp-chaos-rig

For optimal performance, consider adjusting the server's configuration settings as per your testing needs. You may want to set environment variables to customize error rates or response times. Common issues include ensuring that your client is correctly handling the various error scenarios that the server can simulate, so thorough testing is recommended.