MCP Log Proxy

mcp-log-proxy is a proxy tool for viewing communication messages between MCP clients and servers through a web interface, supporting the STDIO interface.

Developer tools Monitoring #Communication Proxy #Log Viewing #Web Interface .Go

rating : 2 points

downloads : 5.9K

update time : 2025-04-28

Open Site

What is the MCP Log Proxy Tool?

The MCP log proxy is a monitoring tool that acts as an intermediary between the MCP client and the server. It can display all communication messages in real-time and allows users to view them through a convenient web interface. It is particularly suitable for debugging and understanding the interactions between MCP components.

How to Use the MCP Log Proxy Tool?

Simply run the proxy and specify your MCP server command as a parameter, and you can view the communication data in real-time through the web interface. Please refer to the relevant documentation for specific operation methods.

Applicable Scenarios

This tool is suitable for any application scenarios that require monitoring and analyzing MCP protocol communication, such as debugging, logging, and performance optimization.

Main Features

Real-time Monitoring

It can capture and display all communication data of the MCP protocol in real-time, ensuring that users can keep abreast of the latest developments immediately.

Multithreaded Processing

It adopts an efficient multithreaded mechanism to ensure stable performance even in high-concurrency scenarios.

Logging Function

It supports persistent storage of communication data in local files for subsequent analysis and auditing.

Usage Guide

Download and install the latest version of the MCP log proxy software from the official channel.

Set the target server address, port number, and other advanced options as needed.

Go to the monitoring interface through the interface to start real-time data capture and display.

Frequently Asked Questions

Will the proxy tool modify the original communication data?

Can it be used compatibly with multiple MCP implementations?

Reference Materials

GitHub Repository Address

View the source code and submit issues.

MCP Protocol Documentation

Understand the detailed MCP protocol specification.

🚀 mcp-log-proxy

mcp-log-proxy can be used to view messages between the MCP client and the MCP server and display them through a web interface.

Currently, only the STDIO interface is supported.

🚀 Quick Start

mcp-log-proxy is a tool that enables users to view messages exchanged between the MCP client and server via a web interface.

📦 Installation

go install github.com/emicklei/mcp-log-proxy@latest

💻 Usage Examples

Basic Usage

mcp-log-proxy requires a -command parameter, which contains the full command line to start the MCP server.

For example, to proxy messages to the melrose-mcp server:

mcp-log-proxy -command melrose-mcp

This example assumes the tool is available in your execution PATH.

Once the proxy starts, messages can be viewed at http://localhost:5656.

Advanced Usage

Optional Flags

You can use the title flag to override the web page title:

mcp-log-proxy -command melrose-mcp -title "Melrōse (proxy)"

You can use the port flag (default is 5656) to override the HTTP port:

mcp-log-proxy -command melrose-mcp -port 9999

You can use the log flag to override the location of the proxy's own error log file:

mcp-log-proxy -command melrose-mcp -log /your/logs/mcp-log-proxy.log

You can also set the browser page title via the title flag:

mcp-log-proxy -command melrose-mcp -title "Melrose MCP 代理"

Claude Examples

This example is for proxying the melrose-mcp server:

"melrōse": {
  "command": "/Users/emicklei/go/bin/mcp-log-proxy",
  "args": [
    "-command",
    "/Users/emicklei/go/bin/melrose-mcp -log /Users/emicklei/Documents/claude-melrose.log",
    "-log",
    "/Users/emicklei/Documents/claude-melrose-proxy.log",
    "-port",
    "7788",
    "-title",
    "Claude Melrose MCP"
  ]
}

An example for proxying the browsermcp server:

"browsermcp": {
  "command": "/Users/emicklei/go/bin/mcp-log-proxy",
  "args": [
    "-command",
    "npx @browsermcp/mcp@latest",
    "-log",
    "/Users/emicklei/Documents/claude-browsermcp-proxy.log",
    "-port",
    "7799",
    "-title",
    "Claude Browser MCP"
  ]
}