MCP Log Proxy
๐๏ธ ๐ - MCP server proxy that offers a Web UI to the full message flow
What is MCP Log Proxy?
MCP Log Proxy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐๏ธ ๐ - mcp server proxy that offers a web ui to the full message flow
๐๏ธ ๐ - MCP server proxy that offers a Web UI to the full message flow
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ๐๏ธ ๐ - MCP server proxy that offers a Web UI to the full mes
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-log-proxyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Log Proxy
MCP Log Proxy is a transparent stdio proxy for MCP servers that captures every JSON-RPC message exchanged between an MCP client and server and makes them visible through a local web UI at http://localhost:5656. It sits between your MCP client (such as Claude Desktop) and the actual MCP server binary, forwarding messages unchanged while logging the full message flow in real time. Developers use it to debug tool call payloads, inspect error responses, trace unexpected behavior, and monitor multiple concurrent MCP server instances โ each proxy registers itself in ~/.mcp-log-proxy-instances.json and the web UI lets you switch between them.
Prerequisites
- Go 1.21 or higher (for go install method), or Homebrew on macOS
- An existing MCP server to proxy (e.g., any stdio-based MCP server)
- Claude Desktop or another MCP client configured to use stdio transport
- A web browser to view the log UI at http://localhost:5656
Install mcp-log-proxy
Install via Homebrew on macOS or directly with Go.
# macOS via Homebrew:
brew tap emicklei/tap
brew install emicklei/tap/mcp-log-proxy
# Or via Go:
go install github.com/emicklei/mcp-log-proxy@latestIdentify the MCP server you want to proxy
Find the full command for the MCP server you want to inspect. You will wrap this command with mcp-log-proxy.
# Example: proxying the melrose-mcp server
which melrose-mcp
# /Users/yourname/go/bin/melrose-mcpTest the proxy from the command line
Run mcp-log-proxy with the -command flag pointing to the target MCP server. Messages will be visible at http://localhost:5656.
mcp-log-proxy -command melrose-mcpUpdate your Claude Desktop configuration to use the proxy
Replace the direct server command with mcp-log-proxy, passing the original server command via the -command argument.
Open the web UI to inspect messages
Open a browser to http://localhost:5656 to see the live MCP message flow. Use the selector to switch between multiple proxy instances if you are proxying more than one server.
MCP Log Proxy Examples
Client configuration
Claude Desktop config that wraps the browsermcp server with mcp-log-proxy for debugging, logging to a file and exposing the web UI on port 7799.
{
"mcpServers": {
"browsermcp": {
"command": "/Users/yourname/go/bin/mcp-log-proxy",
"args": [
"-command",
"npx @browsermcp/mcp@latest",
"-log",
"/Users/yourname/Library/Logs/claude-browsermcp-proxy.log",
"-port",
"7799",
"-title",
"Claude Browser MCP"
]
}
}
}Prompts to try
mcp-log-proxy is a debugging tool โ use these approaches to inspect MCP traffic while interacting with the proxied server normally through Claude.
- Open http://localhost:5656 in your browser, then ask Claude any question that triggers the proxied server's tools
- "List all files in the current directory" (when proxying a filesystem MCP server)
- After each Claude response, refresh the proxy web UI to see the exact JSON-RPC tool call and result payloads
- Run two proxies on different ports (e.g. -port 7788 and -port 7799) and use the web UI selector to switch between themTroubleshooting MCP Log Proxy
Web UI at http://localhost:5656 shows no messages
Ensure the proxy is running (it starts when Claude Desktop launches the MCP server). Trigger a tool call from Claude Desktop and then refresh the browser. If port 5656 is taken by another process, mcp-log-proxy will auto-select a different port โ check the proxy's startup output or ~/.mcp-log-proxy-instances.json for the actual port.
Port conflict when running multiple proxies
mcp-log-proxy automatically detects port conflicts and picks a different port. Use the -port flag explicitly on each proxy instance to assign fixed ports (e.g., -port 7788 and -port 7799). All instances are discoverable through the web UI's instance selector.
The proxied MCP server fails to start when wrapped with mcp-log-proxy
Ensure the command passed to -command is available on the PATH that Claude Desktop uses (which may differ from your shell PATH). Use full absolute paths for both mcp-log-proxy and the target server command in the Claude Desktop config.
Frequently Asked Questions about MCP Log Proxy
What is MCP Log Proxy?
MCP Log Proxy is a Model Context Protocol (MCP) server that ๐๏ธ ๐ - mcp server proxy that offers a web ui to the full message flow It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Log Proxy?
Follow the installation instructions on the MCP Log Proxy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Log Proxy?
MCP Log Proxy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Log Proxy free to use?
Yes, MCP Log Proxy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Log Proxy Alternatives โ Similar Developer Tools Servers
Looking for alternatives to MCP Log Proxy? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
โ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
โ 155.8kJava ้ข่ฏ & ๅ็ซฏ้็จ้ข่ฏๆๅ๏ผ่ฆ็่ฎก็ฎๆบๅบ็กใๆฐๆฎๅบใๅๅธๅผใ้ซๅนถๅใ็ณป็ป่ฎพ่ฎกไธ AI ๅบ็จๅผๅ
Gemini CLI
โ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
โ 87.3kโญ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
โ 86.0kModel Context Protocol Servers
CC Switch
โ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Log Proxy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Log Proxy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.