mcp-log-proxy

mcp-log-proxy : proxy JSON-RPC stdio pour les flux de travail de débogage MCP

mcp-log-proxy, par Emicklei, est un utilitaire de développement local qui expose la communication entre les clients et les serveurs MCP afin que les ingénieurs puissent inspecter les échanges de protocoles. L'outil intercepte et enregistre les messages JSON-RPC échangés lors des sessions MCP, produisant une trace lisible pour l'analyse et le dépannage. Les éléments clés incluent un proxy transparent, le support du transport stdio, et une implémentation basée sur Go qui maintient l'exécution légère. Il cible les ingénieurs logiciels et les développeurs d'IA déboguant les intégrations MCP dans des environnements de bureau et de serveur local.

Vous pouvez capturer chaque message JSON-RPC sans altérer le flux de protocole

mcp-log-proxy agit comme un middleware transparent qui se situe entre le client et le serveur et enregistre le trafic des messages pour inspection. Les développeurs obtiennent une vue chronologique des requêtes, des réponses, des notifications et des appels d'outils, ce qui aide à vérifier le format des messages et la structure des arguments. Le proxy ne modifie pas la logique du protocole, donc les traces capturées reflètent l'interaction non altérée entre le client MCP et le backend.

La journalisation est mieux adaptée aux connexions MCP locales basées sur stdio

L'outil se concentre sur la couche de transport stdio, qui est le transport local commun pour les implémentations MCP. Cela rend la journalisation fiable pour les flux de travail locaux de bureau et de serveur qui utilisent l'entrée/sortie standard, tandis que d'autres transports reçoivent moins d'accent. L'implémentation Go est décrite comme légère, ce qui supporte le proxy à faible latence pendant les flux de travail de développement où la réactivité est importante.

L'installation et l'intégration s'intègrent dans les flux de travail des développeurs existants avec des commandes simples

L'installation utilise la chaîne d'outils Go et une seule commande d'installation, permettant une configuration rapide pour les ingénieurs qui utilisent Go. L'intégration consiste à préfixer la commande du serveur dans les configurations des clients pour acheminer le trafic à travers le proxy. L'utilisation typique s'inscrit dans des environnements de test locaux et des étapes CI qui exercent des serveurs MCP sans changer le code du serveur.

Les fichiers journaux locaux fournissent une visibilité côté hôte mais nécessitent une gestion opérationnelle

Par défaut, le proxy écrit des journaux dans un fichier local dans le répertoire d'exécution, donnant aux équipes un contrôle direct sur les données enregistrées sur l'hôte. Cela garde les traces sur la machine du développeur pour une inspection privée, cependant cela crée également un besoin opérationnel de rotation, d'archivage ou d'indexation lorsque les sessions durent longtemps ou lorsque plusieurs exécutions accumulent de gros fichiers.

Un outil pratique, axé sur l'inspection pour le développement MCP

mcp-log-proxy est une option pragmatique pour les ingénieurs qui ont besoin de traces de protocole lisibles lors du développement et du dépannage locaux de MCP. Son design passif privilégie l'inspection passive plutôt que la manipulation active des protocoles, donc les équipes qui nécessitent l'injection de messages ou une large couverture de transport devraient le combiner avec des outils de traçage complémentaires. Pour une analyse plus rapide, redirigez les journaux vers un pager ou un indexeur compatible JSON pour rechercher et filtrer efficacement de grandes traces.