MCP服务器监控工具

lpx是一款无需代码更改即可监控任何MCP服务器的工具,通过拦截JSON-RPC流量捕获工具调用分析、错误和会话数据。

  • by cloudbox-sh
  • Go
  • 本地部署
  • 更新于

使用说明

液态羽流图像实验

使用以下命令监视任何MCP服务器 日志窗格。无需更改代码。

lpx 位于MCP客户端和服务器之间,拦截JSON-RPC流量以捕获工具调用分析、错误和会话数据。它适用于任何MCP服务器,无论语言或框架如何。

建筑

需要Go 1.21+。

当前平台

go build -o lpx ./cmd/lpx

跨平台编译

Linux(x86_64):

CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o lpx-linux-amd64 ./cmd/lpx

macOS(苹果硅):

CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -ldflags="-s -w" -o lpx-darwin-arm64 ./cmd/lpx

Windows(x86_64):

CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o lpx-windows-amd64.exe ./cmd/lpx

一次性构建

CGO_ENABLED=0 GOOS=linux   GOARCH=amd64 go build -ldflags="-s -w" -o dist/lpx-linux-amd64       ./cmd/lpx
CGO_ENABLED=0 GOOS=darwin  GOARCH=arm64 go build -ldflags="-s -w" -o dist/lpx-darwin-arm64       ./cmd/lpx
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o dist/lpx-windows-amd64.exe ./cmd/lpx

用法

标准模式

包装任何MCP服务器命令。将此用于通过stdin/stdout进行通信的服务器。

lpx --key YOUR_API_KEY -- node my-server.js
lpx --key YOUR_API_KEY -- python server.py
lpx --key YOUR_API_KEY -- ./my-mcp-binary

MCP客户端配置:

{
  "mcpServers": {
    "my-server": {
      "command": "lpx",
      "args": ["--key", "YOUR_API_KEY", "--", "node", "my-server.js"]
    }
  }
}

SSE代理模式

反向代理基于SSE的MCP服务器。将此用于通过HTTP/SSE进行通信的服务器。

lpx --key YOUR_API_KEY --proxy http://localhost:8081 --port 9090

MCP客户端配置:

{
  "mcpServers": {
    "my-server": {
      "type": "sse",
      "url": "http://localhost:9090/sse"
    }
  }
}

旗帜

标志 描述 默认值
--key Logpane API密钥(必需,或已设置 LOGPANE_API_KEY env) 。
--endpoint 日志窗格API终结点 https://api.logpane.dev
--proxy SSE代理模式:目标MCP服务器URL
--port SSE代理模式:监听本地端口 9090
--name MCP服务器名称(如果未设置,则从命令中自动检测到)
--version 打印版本并退出

捕获什么

  • 工具调用 --工具名称、持续时间、成功/失败
  • 错误 --JSON-RPC错误代码和消息
  • 会话 --开始和结束事件

所有事件都会在后台发送到Logpane API。如果无法访问Logpane,MCP服务器将继续正常工作。

运行测试

go test ./... -v