mcp-log-proxy

mcp-log-proxy: proxy JSON-RPC stdio para fluxos de trabalho de depuração MCP

mcp-log-proxy, por Emicklei, é uma ferramenta de desenvolvedor local que expõe a comunicação entre clientes e servidores MCP para que os engenheiros possam inspecionar as trocas de protocolo. A ferramenta intercepta e grava mensagens JSON-RPC trocadas durante as sessões MCP, produzindo um rastreamento legível para análise e solução de problemas. Os elementos-chave incluem proxy transparente, suporte a transporte stdio e uma implementação baseada em Go que mantém a execução leve. Ela é direcionada a engenheiros de software e desenvolvedores de IA que estão depurando integrações MCP em ambientes de desktop e servidores locais.

Você pode capturar cada mensagem JSON-RPC sem alterar o fluxo do protocolo

mcp-log-proxy atua como um middleware transparente que fica entre o cliente e o servidor e registra o tráfego de mensagens para inspeção. Os desenvolvedores obtêm uma visão cronológica de solicitações, respostas, notificações e chamadas de ferramentas, o que ajuda a verificar o formato da mensagem e a estrutura dos argumentos. O proxy não modifica a lógica do protocolo, portanto, os rastros capturados refletem a interação não alterada entre o cliente MCP e o backend.

O registro é mais adequado para conexões MCP locais baseadas em stdio

A ferramenta foca na camada de transporte stdio, que é o transporte local comum para implementações MCP. Isso torna o registro confiável para fluxos de trabalho locais de desktop e servidor que usam entrada/saída padrão, enquanto outros transportes recebem menos ênfase. A implementação em Go é descrita como leve, o que suporta proxying de baixa latência durante fluxos de trabalho de desenvolvimento onde a responsividade é importante.

Instalação e integração se encaixam nos fluxos de trabalho existentes dos desenvolvedores com comandos simples

A instalação utiliza a ferramenta Go e um único comando de instalação, permitindo uma configuração rápida para engenheiros que usam Go. A integração é uma questão de prefixar o comando do servidor nas configurações do cliente para direcionar o tráfego através do proxy. O uso típico se encaixa em ambientes de teste locais e etapas de CI que exercitam servidores MCP sem alterar o código do servidor.

Arquivos de log locais fornecem visibilidade do lado do host, mas requerem manuseio operacional

Por padrão, o proxy grava logs em um arquivo local no diretório de execução, dando às equipes controle direto sobre os dados gravados no host. Isso mantém os rastros na máquina do desenvolvedor para inspeção privada, no entanto, também cria uma necessidade operacional de rotação, arquivamento ou indexação quando as sessões duram muito ou quando várias execuções acumulam arquivos grandes.

Uma ferramenta prática, focada em inspeção para desenvolvimento de MCP

mcp-log-proxy é uma opção pragmática para engenheiros que precisam de rastros de protocolo legíveis durante o desenvolvimento e solução de problemas locais de MCP. Seu design passivo favorece a inspeção passiva em vez da manipulação ativa de protocolos, portanto, equipes que requerem injeção de mensagens ou ampla cobertura de transporte devem combiná-lo com ferramentas de rastreamento complementares. Para uma análise mais rápida, envie logs para um pager ou indexador que reconheça JSON para pesquisar e filtrar grandes rastros de forma eficiente.