https://github.com/emicklei/mcp-log-proxy

a web logging proxy for MCP client-server communication
https://github.com/emicklei/mcp-log-proxy

debug golang mcp-server mcp-tools

Last synced: 13 days ago
JSON representation

a web logging proxy for MCP client-server communication

• Host: GitHub
• URL: https://github.com/emicklei/mcp-log-proxy
• Owner: emicklei
• License: mit
• Created: 2025-04-21T03:13:07.000Z (17 days ago)
• Default Branch: main
• Last Pushed: 2025-04-22T12:37:18.000Z (16 days ago)
• Last Synced: 2025-04-22T13:31:39.865Z (16 days ago)
• Topics: debug, golang, mcp-server, mcp-tools
• Language: Go
• Homepage:
• Size: 10.7 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-devtools - emicklei/mcp-log-proxy - An MCP proxy server that offers a Web UI to see the complete message flow. (Utilities / Proxies and Gateways)
• awesome-mcp-devtools - emicklei/mcp-log-proxy - An MCP proxy server that offers a Web UI to see the complete message flow. (Utilities / Proxies and Gateways)

README

        
## mcp-log-proxy

`mcp-log-proxy` can be used to see the messages to and from a MCP client and a MCP server using a Web interface.

Currently, it only supports the STDIO interface.

![web log view](doc/screenshot1.png)

## install

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

### usage

`mcp-log-proxy` requires one argument `-command` that contains the full command line for starting the MCP server.

For example, to proxy traffic to the `melrose-mcp` server, the full command is:

    mcp-log-proxy -command melrose-mcp

This example assumes that both tools are available on your execution PATH.

Once the proxy is started, messages can be viewed on `http:/localhost:5656`.

#### optional flags

You can override the Web page title using the `title` flag:

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

You can override the HTTP port(default 5656) using the `port` flag:

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

You can set override the log file location of the proxy that captures errors in the proxy itself.

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

You can set the browser page title using the `title` flag:

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

### Claude examples

This example proxies the use of 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"

      ]

    },

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"

      ]

    }

© 2025, https://ernestmicklei.com. MIT License.