MCP Sniffer

🚀 MCP抓包工具

MCP抓包工具 は、MCPクライアントとサーバー間のネットワークトラフィックをキャプチャします。

このツールは、クライアントとサービスの間にリバースプロキシとして動作し、リクエストとレスポンスのペイロードをキャプチャします。これらのペイロードはWeb UIで視覚化することができます。

下の図は、MCP抓包工具がMCPクライアント - サービスモデルにどのように組み込まれるかを示しています。

Web UIについては、Google Chrome DevTools' のネットワークタブを モデルコンテキストプロトコル に適用したものを想像してください。

以下は、非常に初期のバージョンです。

🚀 クイックスタート

MCP抓包工具は、MCPクライアントとサーバー間のネットワークトラフィックをキャプチャし、その内容をWeb UIで視覚化できる便利なツールです。以下に、その使い方を説明します。

✨ 主な機能

• MCPクライアントとサーバー間のネットワークトラフィックをキャプチャします。
• リバースプロキシとして動作し、リクエストとレスポンスのペイロードを取得します。
• 取得したペイロードをWeb UIで視覚化できます。

📦 インストール

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退出）

📚 ドキュメント

Web UIのアクセス

Web UIにアクセスするには、http://127.0.0.1:8888 をブラウザで開きます。

設定画面