Wireshark MCP

🚀 Wireshark MCP 服務器

該項目藉助模型上下文協議（MCP）開放了 PyShark 功能，讓諸如 Claude 之類的 AI 助手能夠與網絡數據包的捕獲和分析功能進行交互。

🚀 快速開始

此項目通過 MCP 協議將 PyShark 功能開放，方便 AI 助手使用網絡數據包捕獲與分析能力。下面為你介紹詳細的安裝和使用方法。

✨ 主要特性

• 藉助 MCP 協議，讓 AI 助手可以輕鬆與網絡數據包捕獲和分析功能交互。
• 提供多種資源信息獲取，如 PyShark 版本、配置和捕獲歷史。
• 具備豐富的工具，涵蓋網絡接口列出、即時數據包捕獲、文件讀取分析等功能。
• 提供高級工具，可捕獲特定流量、保存為文件、分析 HTTP 流量等。
• 提供使用提示，方便用戶操作。

📦 安裝指南

安裝依賴

你可以選擇以下任意一種方式安裝所需的依賴項：

# 使用 uv（推薦）
uv add mcp[cli] pyshark

# 或使用 pip
pip install mcp[cli] pyshark

克隆倉庫

git clone https://github.com/A-G-U-P-T-A/wireshark-mcp
cd wireshark-mcp

💻 使用示例

運行服務器

開發模式

你可以在開發模式下運行服務器並使用 MCP 檢查器：

mcp dev pyshark_mcp.py

直接安裝

或者直接在 Claude Desktop 中安裝它：

mcp install pyshark_mcp.py

可用功能

資源

• pyshark://version - 獲取 PyShark 版本信息
• pyshark://config - 獲取 PyShark 配置
• pyshark://capture-history - 獲取之前的數據包捕獲歷史記錄

工具

• list_interfaces - 列出所有可用的網絡接口
• capture_live_packets - 從網絡接口即時捕獲數據包
• read_pcap_file - 讀取並分析數據包捕獲文件
• analyze_traffic - 分析捕獲的數據包中的網絡流量模式

高級工具

在 advanced_captures.py 中提供了以下高級工具：

• capture_targeted_traffic - 捕獲目標到特定主機、端口或協議的流量
• capture_to_file - 捕獲網絡流量並保存為 pcap 文件
• analyze_http_traffic - 分析捕獲文件中的 HTTP 流量
• detect_network_protocols - 檢測並報告使用的網絡協議

提示

• packet_capture_help - 提供關於使用 PyShark 進行數據包捕獲的幫助信息

在 Claude 中的使用示例

一旦服務器安裝在 Claude Desktop 中，你可以像這樣與它交互：

您：有哪些可用的網絡接口用於捕獲？

Claude：讓我檢查一下您系統上可用的網絡接口。
[調用 list_interfaces 工具]

您：你能捕獲 10 秒的 HTTP 流量嗎？

Claude：我將捕獲 10 秒的 HTTP 流量。
[調用 capture_live_packets 和適當參數]

您：你能分析我剛剛捕獲的流量嗎？

Claude：以下是 captured traffic 的分析：
[調用 analyze_traffic 提供見解]

📚 詳細文檔

要求

• Python 3.8+
• TShark（Wireshark 的命令行組件）必須安裝
• 即時數據包捕獲的管理權限/根權限

安全注意事項

網絡數據包捕獲是一項敏感操作。請確保：

1. 您獲得合法授權以捕獲網絡流量
2. 遵守所有適用的法律法規
3. 不要意外捕獲敏感或私人數據
4. 安全處理捕獲文件，防止未經授權的訪問

依賴說明

• PyShark：TShark 的 Python 封裝
• TShark：Wireshark 的命令行版本（必須單獨安裝）
• 管理權限：通常需要進行即時數據包捕獲

⚠️ 重要提示

請始終確保您有權限捕獲網絡流量，並且遵守相關法律法規，避免捕獲敏感或私人數據。

💡 使用建議

在使用即時數據包捕獲功能時，請確保您具備管理權限/根權限，以避免出現權限不足的問題。