Zeek-MCP

Zeek-MCP

Этот репозиторий предоставляет набор утилит для создания сервера MCP (Model Context Protocol), который можно интегрировать с вашим клиентом разговорного ИИ.

Оглавление

• Предпосылки
• Установка
• Использование
  • 1. Клонировать репозиторий
  • 2. Установка зависимостей
  • 3. Запустите MCP-сервер.
  • 4. Используйте инструменты MCP
• Примеры
• Лицензия

Предпосылки

• Питон 3.7+
• Zeek установлен и доступен в вашем PATH (для инструмента execzeek )
• pip (для установки зависимостей Python)

Установка

1. Клонировать репозиторий

2. Установка зависимостей

Рекомендуется использовать виртуальную среду:

Примечание: Если у вас нет файла requirements.txt , выполните установку напрямую:

pip install pandas mcp

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

Репозиторий предоставляет два основных инструмента MCP и точку входа в командную строку:

3. Запустите сервер MCP

• --mcp-host : Хост для сервера MCP (по умолчанию: 127.0.0.1 ).
• --mcp-port : Порт для сервера MCP (по умолчанию: 8081 ).
• --transport : Транспортный протокол, sse (события, отправленные сервером) или stdio .

4. Используйте инструменты MCP

Вам необходимо использовать LLM, который может поддерживать использование инструментов MCP, вызывая следующие инструменты:

1. execzeek(pcap_path: str) -> str
   • Описание: Запускает Zeek для указанного файла PCAP после удаления существующих файлов .log в рабочем каталоге.
   • Возвращает: строку со списком сгенерированных имен файлов .log или "1" в случае ошибки.
2. parselogs(logfile: str) -> DataFrame
   • Описание: Анализирует один файл Zeek .log и возвращает проанализированное содержимое.

Вы можете взаимодействовать с этими конечными точками через HTTP (если используется транспорт SSE) или путем встраивания в клиент LLM (например, Claude Desktop):

Интеграция с Claude Desktop:

Чтобы настроить Claude Desktop в качестве клиента Zeek MCP, перейдите в Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json и добавьте следующее:

Либо отредактируйте этот файл напрямую:

Интеграция 5ire:

Другой клиент MCP, который поддерживает несколько моделей на бэкэнде — это 5ire . Чтобы настроить Zeek-MCP, откройте 5ire и перейдите в Tools -> New и установите следующие конфигурации:

1. Ключ инструмента: ZeekMCP
2. Имя: Zeek-MCP
3. Команда: python /ABSOLUTE_PATH_TO/Bridge_Zeek_MCP.py

В качестве альтернативы вы можете использовать фреймворк Chainlit и следовать документации для интеграции сервера MCP.

Примеры

Пример использования инструментов MCP из клиента чат-бота Chainlit, был использован пример файла pcap (несколько из них можно найти в папке pcaps)

Лицензия

Более подробную информацию см. в LICENSE .