Mcp Log Proxy

Name: Mcp Log Proxy
Author: emicklei

本地服务

github.com/emicklei开发工具3222 周前更新

代码仓库

关于 Mcp Log Proxy

mcp-log-proxy 是一个命令行代理工具，用于在 MCP 客户端与 MCP 服务之间转发 STDIO 消息，并通过网页界面查看这些消息。它适合调试 MCP 通信的开发者，并支持同时运行多个代理实例。

主要功能

01通过网页查看 STDIO 通信消息
02支持多个代理实例并可切换
03可设置主机、端口与页面标题
04代理自身错误可写入日志文件

适用场景

01调试 Claude Desktop 或 Goose 与 MCP 服务之间的消息
02同时监控多个 MCP 服务的通信过程

MCP 相关

该项目是位于 MCP 客户端与 MCP 服务之间的代理，目前仅支持 STDIO 接口，用于记录和展示双向 MCP 消息。

#golang #debug #mcp-server #mcp-tools

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-log-proxy

mcp-log-proxy 可通过 Web 界面查看 MCP 客户端与 MCP 服务之间收发的消息。

目前，它仅支持 STDIO 接口。

Web 日志视图

多个代理

多条流

所有正在运行的 mcp-log-proxy 进程都会在你的主目录中的 .mcp-log-proxy-instances.json 文件里注册。在网页上，你可以使用选择器切换到其他代理实例。

安装

brew tap "emicklei/tap"

然后

brew install emicklei/tap/mcp-log-proxy

或通过 Go 安装

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

用法

mcp-log-proxy 需要一个 -command 参数，其中包含启动 MCP 服务的完整命令行。

例如，要代理发往 melrose-mcp 服务的流量，完整命令如下：

mcp-log-proxy -command melrose-mcp

此示例假定这两个工具都可通过执行路径找到。

代理启动后，可以在 http://localhost:5656 查看消息。

可选标志

你可以使用 host 标志覆盖 HTTP 主机地址（默认为 localhost），例如监听所有接口或特定接口地址：

mcp-log-proxy -command melrose-mcp -host 0.0.0.0
mcp-log-proxy -command melrose-mcp -host 1.2.3.4

你可以使用 title 标志覆盖网页标题：

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

你可以使用 port 标志覆盖 HTTP 端口（默认为 5656）：

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

运行多个代理时，mcp-log-proxy 会检测 HTTP 端口是否已被占用，并改用其他端口。你可以通过 Web UI 选择其他正在运行的代理。

你可以使用 log 标志覆盖代理日志文件的位置，该文件用于记录代理自身发生的错误：

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

Claude 示例

此示例代理对 melrose-mcp 服务的使用。查找二进制文件，以获取正确的路径。

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

代理 browsermcp 服务。

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

Goose 示例

此示例代理对 melrose-mcp 服务的使用。查找二进制文件，以获取正确的路径。

/Users/SOME-USER/go/bin/mcp-log-proxy -command /Users/SOME-USER/go/bin/melrose-mcp -log /Users/SOME-USER/Library/Logs/goose-melrose.log -port 8888 -title Melrose-MCP