金大哥 - mcp-sniffer MCP 详情

article

README

🚀 MCP抓包工具

MCP抓包工具可捕捉MCP客户端和服务器之间的网络流量。它作为反向代理运行于客户端和服务之间，能够捕获请求和响应的有效负载，并在Web UI中进行可视化展示。

🚀 快速开始

MCP抓包工具在MCP客户端 - 服务模型中扮演着重要角色，通过反向代理的方式，实现对网络流量的捕获和可视化。以下是它在整个模型中的工作流程展示：流程图

对于Web UI，你可以想象它类似于 Google Chrome DevTools 的网络选项卡，只不过这里是针对模型上下文协议的。下面是该工具非常早期的一个版本界面展示：浏览连接

✨ 主要特性

流量捕获：能够精准捕捉MCP客户端和服务器之间的网络流量。
可视化展示：捕获的请求和响应有效负载可在Web UI中进行可视化，方便用户查看。
类似DevTools体验：Web UI的操作体验类似于Google Chrome DevTools的网络选项卡，易于上手。

📦 安装指南

使用以下命令进行安装：

pipx 安装 mcp-sniffer

💻 使用示例

基础用法

查看帮助信息：

$ mcp-sniffer --help
用法：mcp-sniffer [-h] [--listen-host LISTEN_HOST] [--listen-port LISTEN_PORT] [--upstream-host UPSTREAM_HOST]
                   [--upstream-port UPSTREAM_PORT] [--web-ui-host WEB_UI_HOST] [--web-ui-port WEB_UI_PORT]
                   [--log-level LOG_LEVEL]

MCP抓包工具

选项：
  -h, --help            显示此帮助消息并退出
  --listen-host LISTEN_HOST
                        监听的主机（默认：环境变量LISTEN_HOST或127.0.0.1）
  --listen-port LISTEN_PORT
                        监听的端口（默认：环境变量LISTEN_PORT或3002）
  --upstream-host UPSTREAM_HOST
                        上游主机（默认：环境变量UPSTREAM_HOST或127.0.0.1）
  --upstream-port UPSTREAM_PORT
                        上游端口（默认：环境变量UPSTREAM_PORT或3001）
  --web-ui-host WEB_UI_HOST
                        Web UI主机（默认：环境变量WEB_UI_HOST或127.0.0.1）
  --web-ui-port WEB_UI_PORT
                        Web UI端口（默认：环境变量WEB_UI_PORT或8888）
  --log-level LOG_LEVEL
                        日志级别（默认：环境变量LOG_LEVEL或INFO）

高级用法

启动抓包工具并指定监听端口和上游端口：

mcp-sniffer --listen-port 3002 --upstream-port 3001
INFO:     启动了服务器进程 [6174]
INFO:     等待应用程序启动。
INFO:     应用程序启动完成。
2025-04-27 19:52:53 devmachine.local mcp_sniffer.proxy[6174] INFO 监听在 ('127.0.0.1', 3002)...
INFO:     Uvicorn 运行在 http://127.0.0.1:8888（按CTRL+C退出）

📚 详细文档

启动抓包工具后，你可以通过访问 http://127.0.0.1:8888 打开Web UI。以下是Web UI的设置界面：

📄 许可证

PyPI - 许可证 PyPI - Python 版本

mcp-sniffer