MCP Sniffer

MCP Sniffer

site icon
2025.04.20 0
Python网络流量捕获反向代理Web UI 可视化开发效率
MCP Sniffer 是一个用于捕获 MCP 客户端和服务器之间网络流量的工具。它作为反向代理运行在客户端和服务器之间,捕获请求和响应的负载,并可以通过 Web UI 进行可视化。该工具类似于 Google Chrome DevTools 的网络标签,但专为 Model Context Protocol (MCP) 设计。
View on GitHub

Overview

基本能力

产品定位

MCP Sniffer 是一个网络流量捕获和可视化工具,专为 MCP 协议设计,帮助开发者调试和分析 MCP 客户端与服务器之间的通信。

核心功能

  1. 网络流量捕获:捕获 MCP 客户端和服务器之间的请求和响应负载。
  2. 反向代理:作为反向代理运行,拦截并记录通信数据。
  3. Web UI 可视化:提供 Web UI 界面,方便开发者查看和分析捕获的数据。
  4. 灵活的配置:支持自定义监听端口、上游服务器端口、Web UI 端口等。

适用场景

  1. 调试 MCP 通信:帮助开发者调试 MCP 客户端和服务器的通信问题。
  2. 性能分析:分析 MCP 请求和响应的性能瓶颈。
  3. 协议研究:研究 MCP 协议的具体实现和通信细节。

工具列表

  1. mcp-sniffer:主程序,用于启动反向代理和 Web UI。
  2. 能力:捕获网络流量、提供 Web UI 可视化、支持灵活配置。

常见问题解答

  1. 如何访问 Web UI?
  2. 启动 mcp-sniffer 后,访问 http://127.0.0.1:8888 即可。
  3. 如何修改监听端口?
  4. 使用 --listen-port 参数指定监听端口。
  5. 如何修改上游服务器端口?
  6. 使用 --upstream-port 参数指定上游服务器端口。

使用教程

使用依赖

  1. 确保已安装 Python 3.7 或更高版本。
  2. 确保已安装 pipx(推荐使用 pipx 安装和管理工具)。

安装教程

pipx install mcp-sniffer

调试方式

  1. 启动 mcp-sniffer:
mcp-sniffer --listen-port 3002 --upstream-port 3001
  1. 访问 Web UI:
  2. 打开浏览器,访问 http://127.0.0.1:8888
  3. 查看日志:
  4. 启动后,终端会输出日志信息,包括监听端口、Web UI 地址等。

许可证

该项目遵循 GPL-3.0 开源许可条款,请参阅 GPL-3.0 了解完整条款。