mcp-log-proxy

mcp-log-proxy: proxy JSON-RPC stdio per flussi di lavoro di debug MCP

mcp-log-proxy, di Emicklei, è un'utilità per sviluppatori locali che espone la comunicazione tra i client e i server MCP in modo che gli ingegneri possano ispezionare gli scambi di protocollo. Lo strumento intercetta e registra i messaggi JSON-RPC scambiati durante le sessioni MCP, producendo una traccia leggibile per analisi e risoluzione dei problemi. Gli elementi chiave includono il proxying trasparente, il supporto per il trasporto stdio e un'implementazione basata su Go che mantiene l'esecuzione leggera. Si rivolge a ingegneri software e sviluppatori di AI che eseguono il debug delle integrazioni MCP in ambienti desktop e server locali.

Puoi catturare ogni messaggio JSON-RPC senza alterare il flusso del protocollo

mcp-log-proxy funge da middleware trasparente che si trova tra client e server e registra il traffico dei messaggi per l'ispezione. Gli sviluppatori ottengono una vista cronologica di richieste, risposte, notifiche e chiamate agli strumenti, il che aiuta a verificare il formato dei messaggi e la struttura degli argomenti. Il proxy non modifica la logica del protocollo, quindi le tracce catturate riflettono l'interazione non alterata tra il client MCP e il backend.

Il logging è più adatto a connessioni MCP locali basate su stdio

Lo strumento si concentra sul livello di trasporto stdio, che è il trasporto locale comune per le implementazioni MCP. Questo rende il logging affidabile per flussi di lavoro desktop e server locali che utilizzano input/output standard, mentre altri trasporti ricevono meno enfasi. L'implementazione in Go è descritta come leggera, il che supporta il proxying a bassa latenza durante i flussi di lavoro di sviluppo in cui la reattività è importante.

L'installazione e l'integrazione si adattano ai flussi di lavoro degli sviluppatori esistenti con comandi semplici

L'installazione utilizza la toolchain Go e un singolo comando di installazione, consentendo un rapido setup per gli ingegneri che utilizzano Go. L'integrazione è una questione di prefissare il comando del server nelle configurazioni del client per instradare il traffico attraverso il proxy. L'uso tipico si adatta agli ambienti di test locali e ai passaggi CI che esercitano i server MCP senza modificare il codice del server.

I file di log locali forniscono visibilità lato host ma richiedono gestione operativa

Per impostazione predefinita, il proxy scrive i log in un file locale nella directory di esecuzione, dando ai team il controllo diretto sui dati registrati sull'host. Questo mantiene le tracce sulla macchina dello sviluppatore per un'ispezione privata, tuttavia crea anche una necessità operativa per la rotazione, l'archiviazione o l'indicizzazione quando le sessioni durano a lungo o quando più esecuzioni accumulano file di grandi dimensioni.

Uno strumento pratico, orientato all'ispezione per lo sviluppo di MCP

mcp-log-proxy è un'opzione pragmatica per gli ingegneri che necessitano di tracce di protocollo leggibili durante lo sviluppo locale di MCP e la risoluzione dei problemi. Il suo design passivo favorisce l'ispezione passiva rispetto alla manipolazione attiva del protocollo, quindi i team che richiedono l'iniezione di messaggi o una copertura di trasporto ampia dovrebbero combinarlo con strumenti di tracciamento complementari. Per un'analisi più rapida, invia i log a un pager o indicizzatore consapevole di JSON per cercare e filtrare grandi tracce in modo efficiente.