Permet aux agents de codage de reproduire des échecs de tests intermittents, de minimiser les entrées de reproduction et de vérifier les corrections de code avec des preuves empiriques.
Aussi connu sous LBarimi/FailTrace
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 1.5.0
- Dernier commit
- 7 sept. 2026
- Licence
- MIT
Qu'est-ce que FailTrace MCP ?
Permet aux agents de codage de reproduire des échecs de tests intermittents, de minimiser les entrées de reproduction et de vérifier les corrections de code avec des preuves empiriques.
Résumé généré à partir du README du projet
À propos du MCP server FailTrace
FailTrace offre aux agents de codage un moyen de gérer les échecs de tests intermittents en créant des preuves empiriques pour le débogage. Il fonctionne via un MCP server local en stdio ou via un CLI, permettant aux développeurs de capturer une base de référence en échec, de minimiser les entrées de reproduction et de vérifier les correctifs de code. L'outil s'exécute localement sur votre machine avec Node.js 22.12+ et npm, ce qui signifie qu'il ne nécessite aucune API IA externe, aucun compte ni aucune télémétrie pour fonctionner.
Les agents peuvent utiliser sept outils MCP spécifiques pour gérer le cycle de vie de l'investigation, incluant la recherche de régression, la minimisation et la vérification. Le système suit les signatures d'échec et les preuves d'investigation sur plusieurs tentatives. Il prend en charge les runners de tests et les assertions existants, avec un support spécifique pour NUnit et les tests Unity EditMode. Pour éviter l'accumulation excessive de données, le serveur limite le stdout et le stderr conservés à 16 MiB par essai et 256 MiB par processus d'exécution ou de minimisation.
Ce que vous pouvez faire avec
- 1Minimiser les entrées de reproductionUn agent peut réduire un ensemble complexe d'entrées à la plus petite quantité de données possible nécessaire pour déclencher un échec de test spécifique.
- 2Vérifier les correctifs de codeUn développeur peut utiliser l'outil pour vérifier si un correctif proposé résout réellement l'échec ciblé par rapport à une base de référence enregistrée.
- 3Identifier les sources de régressionLe système peut aider à trouver quel changement Git spécifique a introduit un test en échec grâce à un processus de bisect.
- 4Capturer les échecs intermittentsLes utilisateurs peuvent exécuter une commande pour répéter un test plusieurs fois afin de capturer une signature d'échec cohérente.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer FailTrace MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller FailTrace MCP dans Claude Code
$ claude mcp add failtrace -- npx -y failtraceInstaller FailTrace MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"failtrace": {
"command": "npx",
"args": [
"-y",
"failtrace"
]
}
}
}Installer FailTrace MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"failtrace": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"failtrace"
]
}
}
}Installer FailTrace MCP dans VS Code CLI
$ code --add-mcp '{"name":"failtrace","type":"stdio","command":"npx","args":["-y","failtrace"]}'Installer FailTrace MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"failtrace": {
"command": "npx",
"args": [
"-y",
"failtrace"
]
}
}
}Installer FailTrace MCP dans Codex
$ codex mcp add failtrace -- npx -y failtraceInstaller FailTrace MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.failtrace] command = "npx" args = ["-y", "failtrace"]
Installer FailTrace MCP dans Gemini CLI
$ gemini mcp add -s user failtrace npx -- -y failtraceInstaller FailTrace MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"failtrace": {
"command": "npx",
"args": [
"-y",
"failtrace"
]
}
}
}Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblelbarimi/failtrace is public and reachablegithub.com/lbarimi/failtrace ↗Réussi
- Le nom du package correspond au dépôt sourcefailtrace names lbarimi/failtrace as sourcenpmjs.com/package/failtrace ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-09-07github.com/lbarimi/failtrace ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from failtraceRéussi
- Aucun avis critique dans le package ou ses dépendances6 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubFailTrace
Reproduce the failure. Check the fix.
A test fails intermittently. Your coding agent changes the code. One passing retry leaves you guessing.
FailTrace repeats the same check, saves a failing baseline, and checks the proposed fix against it. Use the CLI or MCP tools to get trial results, a smaller reproducer, and evidence your agent can inspect before accepting a patch.
Local execution. No AI API, account, or telemetry required. Keep your existing test runner and assertions.
Quick start
With Node.js 22.12+ and npm, run this in any working directory:
npx --yes failtrace demo

Static walkthrough · Static poster · Demo guide
The demo reduces six input items to ["BUG"], rejects a patch that crashes for another reason, and checks a working patch. It saves the evidence in .failtrace/ and prints a replay command.
For coding agents
Connect the local stdio MCP server through your client's configuration:
npx --yes failtrace@1.5.0 mcp --cwd "/absolute/path/to/your/project"
Copy the MCP configuration and check the connection →
Your client launches this command. Running it alone in a terminal waits for MCP requests. The guide includes Windows setup.
Then ask your agent:
Use FailTrace to capture this test failure before editing. Choose the exact test or failure message, save a bounded baseline, and inspect the matching trial. After the change, verify against that baseline and explain any unrelated errors or incomplete evidence.
The seven MCP tools share the CLI's Core engine. They retain the failure signature and investigation evidence across repetition, comparison, regression search, minimization, verification and replay. Agents can retrieve saved trial and log pages without rerunning the command. Shell-capable agents can also use the CLI with --json.

The agent can inspect the saved failure before checking the patch.
Recheck an existing unit test
Follow an exact NUnit or Unity test through a fix. Each attempt gets a fresh NUnit 3 report. Missing or skipped tests and unrelated failures stay inconclusive, so an agent cannot accept them as evidence that the selected test passed.
Connect your test or try the original EditMode example →
NUnit support is included in 1.3.0 through CLI and MCP. The documented Unity validation covers the Windows EditMode example.

The selected test stays the same; a skipped report is not accepted as a passing test.
Use it on your own failure
From your project, replace the command and message with your own:
npx --yes failtrace@1.5.0 run "npm test -- checkout" --repeat 20 --stderr-contains "checkout failed" --capture-context
Run this before editing in a Git project. --capture-context records source identity for Verify; outside Git, select files with --context-source. Each trial saves its output, and exit 1 can mean the target was captured successfully. Then edit and verify the patch →
| Your next question | Command |
|---|---|
| How often does this failure appear? | run |
| What differs between a healthy and failing trial? | compare |
| Which Git change introduced it? | bisect |
| What input is enough to reproduce it? | minimize |
| What happened after the proposed fix? | verify |
| How can I replay this investigation? | bundle |
Command reference · Literal executable arguments · Reusable project scripts

The demo's bundle reproduces its original failure with exit 1. Keep the source, input and replay together; supply the target's prerequisites when packaging your own investigation.
What the results establish
FailTrace reports observations under the chosen settings. Verify separates a target observed, a healthy sample without that target, and inconclusive evidence. Bisect reports a sampled first-parent boundary; minimization rechecks its result without promising the smallest possible input.
The demo shows controlled example outcomes, not performance measurements. A passing sample does not prove a bug is gone.
Commands run with your permissions, and process cleanup is best effort. Retained stdout/stderr is capped by default at 16 MiB per trial and 256 MiB per run or bisect/minimization. Previous investigations accumulate separately. Review logs, commands and selected files before sharing; bundles still require the target's dependencies and setup.
Result and exit-code reference · Resource limits · Storage inventory · Bundle guide
Availability and contributing
The quick start uses npm's latest release; the verified version is 1.5.0. MCP configuration and repeatable installation examples keep that exact version pinned: installation options, GitHub release, and MCP Registry entry.
Version 1.5.0 adds: short run references, Verify readiness and next-step guidance, and intermittent-minimization guidance. See the changelog.
Documentation: choose your next task →
Development instructions · Compatibility · Roadmap · Third-party notices
Questions sur FailTrace MCP
Comment ajouter FailTrace MCP à Claude Code ?
Exécutez claude mcp add failtrace -- npx -y failtrace dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter FailTrace MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
FailTrace nécessite-t-il une API IA ou un compte ?
Non, il effectue une exécution locale sans nécessiter d'API IA, de compte ou de télémétrie.
Puis-je utiliser FailTrace avec des tests NUnit ?
Oui, la prise en charge de NUnit est incluse depuis la version 1.3.0 et les versions ultérieures via le CLI et le MCP.
Quelles sont les limites de ressources pour les logs ?
Le stockage de stdout/stderr est limité à 16 MiB par essai et 256 MiB par exécution, bisect ou minimisation.
Un échantillon réussi prouve-t-il qu'un bug est corrigé ?
Non, un échantillon réussi ne constitue pas une preuve absolue que le bug a disparu.