MCP Sniffer

🚀 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的設置界面：

📄 許可證