MCP Stdio Guard

Ce qu'il fait

MCP Stdio Guard est un outil de diagnostic d'exécution conçu pour valider la santé et la conformité au protocole des serveurs MCP stdio. Comme les serveurs MCP utilisent le stdout comme canal de communication principal, tout log de débogage accidentel, instruction print ou bannière peut corrompre le flux JSON-RPC, entraînant des échecs clients cryptiques. Cet outil agit comme un proxy et un validateur pour garantir que votre serveur est véritablement « silencieux » et conforme.

Outils

En tant qu'utilitaire de diagnostic, cet outil n'expose pas lui-même d'outils MCP mais valide les éléments suivants sur les serveurs cibles :

• Handshake d'initialisation : Vérifie que le serveur complète correctement le cycle de vie du protocole.
• Sondage des capacités : Vérifie que les outils, ressources et prompts annoncés sont effectivement réactifs.
• Validation du stdout : Recherche les trames non-JSON qui polluent le flux de transport.
• Analyse statique : Analyse le code source pour détecter les appels risqués à console.log ou print.

Installation

Exécutez votre serveur derrière le guard en utilisant npx :

npx mcp-stdio-guard -- node ./server.js

Hôtes supportés

Confirmé pour une utilisation avec tout client MCP supportant le transport stdio, testé spécifiquement pour Claude Desktop et Cursor.