MCP Failure Lab

Présentation

MCP Failure Lab est une boîte à outils de chaos engineering et de tests de résilience pour les clients et serveurs MCP. Son serveur intégré expose des outils de simulation de pannes comme le délai, le blocage, la déconnexion, les messages malformés, les réponses en double et la perte de session, afin de vérifier à la fois l’appel en échec et le bon fonctionnement de la requête suivante sur la même connexion.

Ce que vous pouvez faire

• Lancer une démo intégrée d’un scénario de délai déterministe
• Provoquer des timeouts, des blocages et des déconnexions de transport sur un client MCP
• Envoyer des réponses JSON-RPC malformées ou en double pour tester la gestion côté client
• Exécuter des fichiers de scénarios sur des serveurs MCP externes HTTP ou stdio
• Produire des rapports JUnit pour la CI avec des codes de sortie documentés
• Servir via stdio ou Streamable HTTP en local

Outils

Les serveurs locaux présentent leurs outils une fois lancés, et celui-ci ne publie pas sa liste à l’avance. Votre client les affiche après l’ajout.

Exemples de prompts

• Appelle l’outil delay et dis-moi combien de temps la réponse a pris.

• Utilise l’outil hang pour que je puisse tester la gestion de l’annulation de mon client.

• Envoie une réponse en double, puis un ping pour vérifier que la connexion fonctionne toujours.

• Déclenche un message malformé et indique comment mon client a réagi.

Configuration

Chaque client lance MCP Failure Lab sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.

claude mcp add --transport stdio mcp-failure-lab -- npx -y mcp-failure-lab

{
  "mcpServers": {
    "mcp-failure-lab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-failure-lab"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-failure-lab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-failure-lab"
      ]
    }
  }
}

code --add-mcp '{"name":"mcp-failure-lab","type":"stdio","command":"npx","args":["-y","mcp-failure-lab"]}'

{
  "servers": {
    "mcp-failure-lab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-failure-lab"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-failure-lab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-failure-lab"
      ]
    }
  }
}

codex mcp add mcp-failure-lab -- npx -y mcp-failure-lab

[mcp_servers.mcp-failure-lab]
command = "npx"
args = ["-y", "mcp-failure-lab"]

gemini mcp add mcp-failure-lab npx -- -y mcp-failure-lab

{
  "mcpServers": {
    "mcp-failure-lab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-failure-lab"
      ]
    }
  }
}

Intégrer

Affichez MCP Failure Lab dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.

Badge pour README Carte pour site web iframe JSON Prompt pour l’IA

Badge pour README

Markdown

[![MCP Failure Lab on mcp.tc](https://mcp.tc/i/mcp-failure-lab/badge.svg)](https://mcp.tc/i/mcp-failure-lab)

HTML

<a href="https://mcp.tc/i/mcp-failure-lab"><img src="https://mcp.tc/i/mcp-failure-lab/badge.svg" alt="MCP Failure Lab on mcp.tc" height="20"></a>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML

<script src="https://mcp.tc/w/mcp-failure-lab.js" async></script>

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

iframe

HTML

<iframe src="https://mcp.tc/embed/mcp-failure-lab" title="MCP Failure Lab on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

https://mcp.tc/i/mcp-failure-lab.json

Ce que signifie chaque champ

Prompt pour l’IA

Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de MCP Failure Lab à votre site.

Markdown

Ajoute à mon site la carte mcp.tc de MCP Failure Lab, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.

Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :

```html
<script src="https://mcp.tc/w/mcp-failure-lab.js" async></script>
```

Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.

```html
<div data-mcptc="mcp-failure-lab"><a href="https://mcp.tc/i/mcp-failure-lab">MCP Failure Lab on mcp.tc</a></div>
```

Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.

Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).

Pour un README ou une autre doc en Markdown, utilise plutôt le badge :

```markdown
[![MCP Failure Lab on mcp.tc](https://mcp.tc/i/mcp-failure-lab/badge.svg)](https://mcp.tc/i/mcp-failure-lab)
```

Référence : https://mcp.tc/fr/embed

Historique des changements

Ce serveur tourne sur votre ordinateur, donc nous suivons son paquet npm : chaque nouvelle version apparaît ici, avec les modifications de son propriétaire.

1. 6 oct. 2026, 21:22 UTC, Vérification automatique

   Début de l’observation : version 0.12.0.

FAQ