Inject deterministic failures into MCP servers to verify recovery behavior and generate executable regression tests.
Also known as aliengineering-byte/resilireplay
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.7.1
- Last commit
- Nov 1, 2026
- License
- Apache-2.0
What is ResiliReplay MCP?
ResiliReplay is an MCP server. Inject deterministic failures into MCP servers to verify recovery behavior and generate executable regression tests.
Summary generated from the project's README
About ResiliReplay MCP server
ResiliReplay provides a testing framework for developers to inject deterministic failures into MCP servers. It allows users to verify how systems handle bounded recovery and duplicate-effect behavior. By turning causal failures into executable regression tests, it helps ensure that server recovery processes work as intended under specific error conditions.
Users can test a reviewed server without starting it by using the mcp test command with a configuration file and specific tool targets. The tool supports a dry-run mode to display a plan before execution, which can then be approved using a plan SHA256 hash. It runs on Node.js versions 22 and 24 and includes a demo mode that uses a local fixture requiring no credentials, accounts, or remote targets.
This utility focuses on security and data privacy by persisting metadata and hashes in evidence digests rather than storing unrestricted tool bodies or credentials. It supports various execution parameters including timeouts, retries, and JSON output. The system is designed to maintain explicit ownership controls when interacting with remote targets.
What you can do with it
- 1Verify server recovery behaviorAsk the AI to inject deterministic failures into a specific MCP tool to see if the server recovers correctly.
- 2Generate regression tests from failuresConvert a specific causal failure into an executable regression test to prevent future occurrences.
- 3Test without external dependenciesRun a local demo to observe failure reproduction and retry logic without needing API keys or remote servers.
Written from the project's README. Every use case is checked against a quote from it.
How to install ResiliReplay MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ResiliReplay MCP in Claude Code
$ claude mcp add resilireplay -- npx -y resilireplayInstall ResiliReplay MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"resilireplay": {
"command": "npx",
"args": [
"-y",
"resilireplay"
]
}
}
}Install ResiliReplay MCP in VS Code
.vscode/mcp.json
{
"servers": {
"resilireplay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"resilireplay"
]
}
}
}Install ResiliReplay MCP in VS Code CLI
$ code --add-mcp '{"name":"resilireplay","type":"stdio","command":"npx","args":["-y","resilireplay"]}'Install ResiliReplay MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"resilireplay": {
"command": "npx",
"args": [
"-y",
"resilireplay"
]
}
}
}Install ResiliReplay MCP in Codex
$ codex mcp add resilireplay -- npx -y resilireplayInstall ResiliReplay MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.resilireplay] command = "npx" args = ["-y", "resilireplay"]
Install ResiliReplay MCP in Gemini CLI
$ gemini mcp add -s user resilireplay npx -- -y resilireplayInstall ResiliReplay MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"resilireplay": {
"command": "npx",
"args": [
"-y",
"resilireplay"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablealiengineering-byte/resilireplay is public and reachablegithub.com/aliengineering-byte/resilireplay ↗Pass
- Package names this repository as its sourceresilireplay names aliengineering-byte/resilireplay as sourcenpmjs.com/package/resilireplay ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for resilireplaynpmjs.com/package/resilireplay/v/0.7.1#provenance ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-01github.com/aliengineering-byte/resilireplay ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from resilireplayPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubResiliReplay
Inject deterministic MCP failures, verify bounded recovery and duplicate-effect behavior, and turn causal failures into executable regression tests.
npx --yes resilireplay@latest mcp demo
The demo is a bundled local fixture: no config, account, credential, paid model, telemetry, or remote target. It runs a clean call, reproduces one deterministic failure, retries once, records zero duplicate effects, generates and executes a regression, prints an evidence digest, and cleans up.
Test a reviewed server without starting it:
npx --yes resilireplay@latest mcp test --config ./mcp.json --server my-server --tool echo --safety inert --dry-run
Repeat the displayed plan with --approve <plan-sha256> to execute it. --json, --output,
--no-regression, --timeout, and --retries map to the same bounded engine. The existing
mcp audit workflow remains supported.
npx --yes resilireplay@latest mcp serve --help
Node.js 22 and 24 are supported. Evidence persists metadata and hashes instead of unrestricted tool bodies or credentials. Remote targets retain explicit ownership controls.
Agent-runtime capture, campaigns, replay, Studio, adapters, MCP-RES v0.1/v0.2, security guidance, and the real packed-package MCP Everything example are documented in the repository README.
Apache-2.0.
ResiliReplay MCP questions
How do I add ResiliReplay MCP to Claude Code?
Run claude mcp add resilireplay -- npx -y resilireplay in your terminal. Add --scope user to make it available in every project.
How do I add ResiliReplay MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What Node.js versions are supported?
The tool supports Node.js versions 22 and 24.
Does the demo require any credentials or remote targets?
No, the demo is a local fixture that requires no configuration, accounts, credentials, paid models, or remote targets.