MCP Log Proxy logo

MCP Log Proxy

by emicklei

Proxies an STDIO MCP server and displays client-server messages in a local Web UI.

Install MCP Log Proxy

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "emicklei-mcp-log-proxy": {
      "command": "npx",
      "args": [
        "-y",
        "@browsermcp/mcp@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The emicklei/mcp-log-proxy MCP server sits between an MCP client and an STDIO MCP server to display their exchanged messages in a Web interface. Start it with the complete command used to launch the target server, then inspect the flow at a local HTTP address. Reach for it when debugging MCP communication, reviewing errors, or monitoring several local proxy instances.

Use cases

  • Inspect MCP client-server message flows
  • Debug an STDIO MCP server
  • Review proxy error information
  • Switch between multiple local proxy instances

Key features

  • STDIO MCP traffic proxying
  • Local Web message-flow viewer
  • Multiple proxy instance selection
  • Configurable host and port
  • Configurable page title and error log

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/19 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @browsermcp/mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars32Stargazers on the source repository.
npm downloads38kPackage downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Log Proxy works

What emicklei/mcp-log-proxy MCP server does

The emicklei/mcp-log-proxy MCP server wraps another MCP server that uses the STDIO transport. It forwards the traffic between the MCP client and the target process while presenting the message flow in a Web UI. This makes it suitable for inspecting requests, responses, and proxy error information during local development.

The project currently supports STDIO only. It does not describe support for MCP servers exposed through other transport types.

How it works

Run the proxy with a -command argument containing the complete command line needed to start the target MCP server. For example, the documented form is mcp-log-proxy -command melrose-mcp, provided that both executables are available on the process PATH. The client is then configured to launch mcp-log-proxy rather than launching the target server directly.

After startup, the Web interface is available at http://localhost:5656 by default. The HTTP host, port, page title, and proxy error log path can be changed with the -host, -port, -title, and -log flags.

Multiple instances can run at the same time. Each process registers in .mcp-log-proxy-instances.json in the user's home directory, and the Web UI provides a selector for switching between registered proxies. If a requested HTTP port is already occupied, another port is selected for an additional proxy instance.

Setup and configuration

Install the emicklei/mcp-log-proxy MCP server with Homebrew or Go. The repository documents the following options:

  • Homebrew: tap emicklei/tap, then install emicklei/tap/mcp-log-proxy.
  • Go: run go install github.com/emicklei/mcp-log-proxy@latest.

A client configuration needs the path to the installed proxy binary. Its arguments should include -command followed by the target MCP server command. The README includes configuration examples for Claude and a command-line example for Goose. Those examples also demonstrate assigning separate ports, titles, and log files to different proxied servers.

Tools and capabilities

The provided MCP tool list contains browser interaction and inspection operations:

  • Navigate to URLs and move backward or forward through browser history.
  • Capture an accessibility snapshot, click or hover on page elements, type into editable controls, and select dropdown options.
  • Press keyboard keys and wait for a specified number of seconds.
  • Retrieve browser console logs and capture screenshots.

The project documentation specifically describes the Web UI as a message-flow viewer for proxied MCP traffic.

Limitations and notes

The proxy only supports the STDIO interface. The target command must be supplied through -command; examples assume the target executable or command is available at the path used in the configuration. The default Web endpoint binds to localhost on port 5656, although both values can be overridden. Proxy errors can be written to a file with -log, independently of any log arguments passed to the target MCP server.

The emicklei/mcp-log-proxy MCP server is released under the MIT License.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Log Proxy

Install it with Homebrew by tapping emicklei/tap and installing emicklei/tap/mcp-log-proxy, or use `go install github.com/emicklei/mcp-log-proxy@latest`.

Configure Claude to launch the installed mcp-log-proxy binary and pass `-command` with the full command line for the target MCP server. The README includes Claude examples with optional log, port, and title arguments.

It currently supports the STDIO interface.

After startup, its Web UI is available at `http://localhost:5656` by default. The port can be changed with the `-port` flag.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Log Proxy AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/emicklei-mcp-log-proxy?style=directory)](https://allmcps.com/mcp/emicklei-mcp-log-proxy)
HTML Embed
<a href="https://allmcps.com/mcp/emicklei-mcp-log-proxy"><img src="https://allmcps.com/api/badge/emicklei-mcp-log-proxy?style=directory" alt="MCP Log Proxy on AllMCPs" /></a>