mcpcap
MCP-сервер mcpcap разбирает PCAP-файлы по DNS, DHCP, ICMP, TCP и SIP и отдает агенту структурированный JSON для диагностики сети
- 54 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает локальные файлы по переданному пути и скачивает дампы по произвольным адресам
- В дампах бывают внутренние адреса и учетные данные, которые попадут в контекст модели
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcpcapОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает локальные файлы по переданному пути и скачивает дампы по произвольным адресам
- В дампах бывают внутренние адреса и учетные данные, которые попадут в контекст модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcpcap — Python-сервер на FastMCP и scapy. Каждому вызову передают путь к локальному файлу или HTTP-адрес дампа, поэтому сервер ничего не хранит между запросами. Поддерживаются форматы .pcap, .pcapng и .cap, удаленный файл скачивается во временную папку и после анализа удаляется. Анализ разбит на модули по протоколам. DNS-модуль достает запросы и ответы, типы записей и частоту запросов. DHCP-модуль прослеживает обмен DISCOVER, OFFER, REQUEST и ACK и выданные адреса. ICMP-модуль считает время ответа на ping, TCP-модуль разбирает жизненный цикл соединений, ретрансмиссии и аномалии, а инструмент analyze_traffic_flow показывает потоки между узлами. SIP-модуль читает сигнализацию звонков по Call-ID и CSeq, capinfos выводит общие сведения о файле. К инструментам приложены подсказки для агента по безопасности, диагностике и расследованию: например, tcp_security_analysis и dhcp_forensic_investigation. Запуск ограничивают параметрами `--modules` и `--max-packets`.
Для кого. Сетевым инженерам и администраторам, которые разбирают дампы трафика с помощью Claude Desktop или Claude Code и не хотят читать пакеты вручную.
Подходит, если
- Звонки по SIP рвутся, и в дампе надо найти, на каком ответе обрывается установка соединения
- Сервис отвечает медленно, подозрение падает на ретрансмиссии TCP
- Клиент остается без адреса DHCP, в дампе видна только часть обмена
- Дамп прислали ссылкой, и скачивать его вручную не хочется
- Нужна быстрая сводка по файлу: размер, протоколы, временной диапазон
Не подходит, если
- Нужен захват живого трафика: сервер читает готовые файлы и сам пакеты не перехватывает
- Протокол за пределами DNS, DHCP, ICMP, TCP и SIP: HTTP, TLS и BGP в планах, но модулей пока нет
- Дамп содержит чувствительные данные, а агент работает с внешней моделью
- Нужен разбор огромного файла целиком: без `--max-packets` анализ не ограничен
Пример запроса к агенту
Проанализируй /captures/call.pcap: найди, на каком SIP-ответе обрывается установка звонка, и покажи Call-ID проблемных диалогов.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
MCPCAP_AUTH_TOKENсекрет- Секрет для HTTP-режима на нестандартном интерфейсе, клиент передает его заголовком Authorization.
Ограничения
Нужен Python 3.10 или новее. Сервер читает готовые дампы и не перехватывает трафик.
Для HTTP-режима на нестандартном интерфейсе требуется токен в переменной MCPCAP_AUTH_TOKEN, клиент передает его заголовком Authorization. Флаг `--allow-unauthenticated-http` отключает токен и предназначен для изолированного запуска, например в Docker с портом на loopback.
Дампы нередко содержат внутренние адреса и учетные данные. Удаленные дампы стоит брать только из доверенных источников.
Как отключить. Удалите запись mcpcap из конфигурации MCP-клиента. Пакет снимает команда `pip uninstall mcpcap`, контейнер Docker останавливают обычным способом.
Частые вопросы
Какие протоколы разбирает mcpcap?
DNS, DHCP, ICMP, TCP и SIP, плюс общую сводку по файлу через capinfos. Для TCP есть отдельные инструменты по соединениям, аномалиям, ретрансмиссиям и потокам трафика. Список модулей ограничивается флагом `--modules`.
Можно ли передать файл по ссылке?
Да. Инструмент принимает HTTP- или HTTPS-адрес дампа, скачивает его во временный файл и удаляет после анализа. Путь локального файла тоже подходит, а в Docker используют путь внутри контейнера, например /pcaps/dns.pcap.
Как подключить mcpcap к Claude Desktop?
Установите пакет и впишите в claude_desktop_config.json сервер с command mcpcap. Транспорт по умолчанию stdio, ничего дополнительно запускать не нужно. Для клиентов с сетевым адресом есть режим `mcpcap --transport http`, он слушает 127.0.0.1:8080/mcp.
Защищен ли HTTP-режим?
На loopback он работает без токена. При привязке к другому интерфейсу сервер требует секрет в MCPCAP_AUTH_TOKEN и проверяет его в каждом запросе, а для доступа извне рекомендуется TLS-прокси.
Что делать с большим дампом?
Ограничьте анализ флагом `--max-packets`, например `mcpcap --max-packets 1000`, и включите только нужные модули через `--modules`. По умолчанию число пакетов не ограничено.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Cisco Packet Tracer: агент планирует сеть, строит ее на холсте и подтверждает связность пингом.
При разборе сетевого сбоя агент получает маршрут до сервиса, а администратор выбирает адрес сервера диагностики и способ доступа.
MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
MCP-сервер для роутеров MikroTik: агент читает и меняет конфигурацию RouterOS по SSH по запросу из чата
Демон mcpd запускает MCP-серверы из одного файла .mcpd.toml и отдает их агентам и скриптам как обычный HTTP API на локальном порту
Агент управляет серверами через каталог объявленных действий: политика решает, что выполнить, а что ждет человека
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcpcap (эта карточка) | да | не нужна | 54 | |
| Kubeshark | да | не нужна | 12 131 | перехват и просмотр живого трафика Kubernetes |
| Network Sketcher Local MCP | да | не нужна | 417 | рисует схемы сети, а mcpcap читает дампы трафика |
Коротко о README
Документация описывает модульную архитектуру: общий базовый класс отвечает за чтение файла и скачивание, а протокольные модули добавляют свои инструменты. Новый протокол подключается наследованием от BaseModule. Для проверки в репозитории лежат образцы dns.pcap и dhcp.pcap, ICMP-примера нет.