日志代理服务

mcp-log-proxy是一个用于通过Web界面查看MCP客户端和服务器之间消息的日志代理工具。

  • by emicklei
  • Go
  • 本地部署
  • 32 星标
  • 更新于
在 GitHub 查看 emicklei/mcp-log-proxy

使用说明

mcp日志代理

mcp-log-proxy 可以使用Web界面查看往返于MCP客户端和MCP服务器的消息。

目前,它只支持STDIO接口。

多个代理

所有正在运行的mcp日志代理进程都将在 .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

此示例假设这两个工具在您的执行PATH中都可用。

启动代理后,可以在上查看消息 http://localhost:5656.

可选标志

您可以覆盖HTTP主机地址(默认 localhost)使用 host 标志,例如监听所有接口或特定接口地址:

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)"   

您可以使用以下命令覆盖HTTP端口(默认5656) port 标志:

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

克劳德示例

此示例代理使用 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"
  ]
}

鹅的例子

此示例代理使用 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

错误信息

© 2025, https://ernestmicklei.com.麻省理工学院执照。