Wireshark MCP (протокол модельного контекста)

Name: Wireshark MCP
Author: sarthaksiddha

Лицензия: Массачусетский технологический институт Питон 3.8+

Сервер Model Context Protocol (MCP) для интеграции возможностей сетевого анализа Wireshark с системами ИИ, такими как Claude. Эта реализация обеспечивает прямую интеграцию с Claude без необходимости ручного копирования/вставки подсказок.

Что такое Wireshark MCP?

Wireshark MCP предоставляет стандартизированный способ для помощников ИИ получать доступ к данным сетевых пакетов и анализировать их через Wireshark. Он устраняет разрыв между низкоуровневыми сетевыми данными и высокоуровневым пониманием ИИ, реализуя протокол контекста модели.

Сервер предоставляет инструменты для:

Захват живого сетевого трафика
Анализ существующих файлов pcap
Извлечение информации, специфичной для протокола
Подведение итогов сетевых потоков

Related MCP server: API Tester MCP Server

Быстрый старт

Установка

# Clone the repository git clone https://github.com/sarthaksiddha/Wireshark-mcp.git cd Wireshark-mcp # Install dependencies pip install -e .

Запуск сервера MCP

# Run with stdio transport (for Claude Desktop) python mcp_server.py --stdio # Run with SSE transport (for other MCP clients) python mcp_server.py --host 127.0.0.1 --port 5000

Настройка рабочего стола Claude

Чтобы настроить Claude Desktop для использования сервера Wireshark MCP:

Открыть рабочий стол Клода
Перейдите в Настройки > Разработчик > Изменить конфигурацию.
Добавьте следующую конфигурацию:

{ "mcpServers": { "wireshark": { "command": "python", "args": [ "/path/to/wireshark-mcp/mcp_server.py", "--stdio" ] } } }

Замените /path/to/wireshark-mcp на фактический путь к вашему репозиторию.

Доступные инструменты

Сервер Wireshark MCP предоставляет следующие инструменты:

capture_live_traffic : захват живого сетевого трафика с помощью tshark
analyze_pcap : Анализ существующего файла pcap
get_protocol_list : Получить список поддерживаемых протоколов

Пример использования в Клоде

После настройки вы сможете использовать сервер Wireshark MCP в Claude с такими запросами:

«Захвати 30 секунд сетевого трафика в моей системе и покажи мне, что происходит»
«Проанализируйте мой файл network.pcap и сообщите мне, есть ли какие-либо подозрительные действия»
«На каких протоколах я могу сосредоточиться при анализе сетевого трафика?»

Основные характеристики

Суммирование пакетов : преобразование больших pcap-файлов в оптимизированные для токенов сводки.
Протокольная разведка : расширенный контекст для распространенных протоколов (HTTP, DNS, TLS, SMTP и т. д.)
Отслеживание потока : группировка связанных пакетов в потоки разговоров
Выделение аномалий : подчеркивание необычных или подозрительных закономерностей.
Шаблоны запросов : готовые запросы для общих задач сетевого анализа.
Генерация визуализации : создание текстовых представлений сетевых шаблонов.
Многоуровневая абстракция : просмотр данных от необработанных байтов до высокоуровневых поведений.
Веб-интерфейс : пользовательский интерфейс на основе браузера для более легкого анализа и визуализации
Интеграция «агент-агент» (A2A) : предоставление анализа пакетов в качестве агента, совместимого с A2A
Расширенная система безопасности : комплексный контроль безопасности для защиты данных и связи
Защита IP-адресов : несколько стратегий анонимизации конфиденциальных сетевых адресов
Безопасная связь : надежные подписи сообщений для безопасной связи между агентами
Кроссплатформенность : работает на Windows, macOS и Linux

Документация

Руководство по интеграции Claude — подробное руководство по подключению к Claude AI
Документация модуля A2A — Руководство по использованию интеграции «агент-агент»
Руководство по безопасности A2A — Вопросы безопасности при интеграции A2A
Руководство по защите IP-адресов — подробное руководство по анонимизации и сокрытию IP-адресов
Руководство менеджера по безопасности — полное руководство по единой структуре безопасности
Подписи безопасности сообщений — руководство по безопасному подписанию и проверке сообщений
Веб-интерфейс README - Информация об использовании веб-интерфейса
Скрипты утилит — полезные скрипты для анализа PCAP

Базовое использование

from wireshark_mcp import WiresharkMCP, Protocol from wireshark_mcp.formatters import ClaudeFormatter # Initialize with a pcap file mcp = WiresharkMCP("capture.pcap") # Generate a basic packet summary context = mcp.generate_context( max_packets=100, focus_protocols=[Protocol.HTTP, Protocol.DNS], include_statistics=True ) # Format it for Claude formatter = ClaudeFormatter() claude_prompt = formatter.format_context( context, query="What unusual patterns do you see in this HTTP traffic?" ) # Save to file for use with Claude with open("claude_prompt.md", "w") as f: f.write(claude_prompt)

Использование с Клодом

Существует три основных способа использования Wireshark MCP с Клодом:

1. Прямая интеграция MCP (НОВОЕ)

Для бесшовной интеграции с Claude Desktop:

# Run the MCP server with stdio transport python mcp_server.py --stdio

Затем настройте Claude Desktop, как описано в разделе «Настройка Claude Desktop» выше. Этот метод обеспечивает прямую интеграцию без необходимости копирования/вставки.

2. Простой подход к сценарию

Для быстрого анализа без сложной настройки (требуется копирование/вставка):

python scripts/simple_pcap_analysis.py path/to/your/capture.pcap

Это сгенерирует файл разметки, который можно скопировать и вставить в Claude по адресу claude.ai .

3. Интеграция API

Для программной интеграции с API Клода:

from claude_client import ClaudeClient # Your implementation from wireshark_mcp import WiresharkMCP from wireshark_mcp.formatters import ClaudeFormatter # Process the PCAP file mcp = WiresharkMCP("capture.pcap") context = mcp.generate_context() # Format for Claude formatter = ClaudeFormatter() prompt = formatter.format_context(context, query="Analyze this network traffic") # Send to Claude API client = ClaudeClient(api_key="your_api_key") response = client.analyze(prompt)

Подробные инструкции по API см. в Руководстве по интеграции Claude .

Требования

Питон 3.8+
Wireshark/tshark установлен и находится в вашем PATH
fastmcp пакет Python

Внося вклад

Вклады приветствуются! Области, где помощь особенно ценится:

Дополнительные анализаторы протоколов
Оптимизация производительности
Документация и примеры
Тестирование с использованием различных вариантов захвата пакетов
Улучшения веб-интерфейса

Подробную информацию о том, как внести свой вклад, смотрите на сайте CONTRIBUTING.md .

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Wireshark MCP