Skip to main content
Glama

WinLog-mcp

by XD3an

🪟 WinLog-mcp

Инструмент Model Context Protocol (MCP) для извлечения и анализа журналов событий Windows (например, Application, System, Security). WinLog-mcp обеспечивает программный доступ для приема и запроса журналов событий Windows, что делает его идеальным для мониторинга безопасности, реагирования на инциденты и автоматизации анализа журналов.

⚠️ Предупреждение: этот инструмент должен запускаться с правами администратора. Пожалуйста, будьте осторожны, чтобы не внести непреднамеренные изменения в вашу систему.


✨ Особенности

  • Принимает журналы Windows Sysmon и сохраняет их в виде файлов в указанном пользователем каталоге.
  • Запрос журналов по временной метке, возврат последних записей событий для анализа или устранения неполадок
  • Полная совместимость с инструментами и экосистемой MCP

📄 Формат лог-файлов

  • Файлы журналов именуются в формате <timestamp>_<log_type>.log в выбранном пути хранения.

MCP-сервер (инструмент, подсказки,...)

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

  • ingest_syslog : принимает последние журналы Sysmon и записывает их в файл
  • query_syslog : запрашивает принятые журналы по временной метке и возвращает последние события

📋 Требования

  • Операционная система: Windows
  • Python: 3.7 или выше
  • Зависимости:

💾 Установка

Клонируйте репозиторий и установите зависимости:

pip install -r requirements.txt

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

🖥️ Установка Sysmon

Ссылка: Руководство по установке Sysmon

cd sysmon install.bat

▶️ Прямой запуск

Запустите инструмент как сервер MCP:

python main.py --storage-path \\PATH\\TO\\logs\\

🧑‍💻 Режим разработки

Вы можете выполнять проверку или отладку с помощью MCP Inspector:

# Run in development mode python \\PATH\\TO\\main.py --storage-path \\PATH\\TO\\logs\\ # Run in inspector mode npx @modelcontextprotocol/inspector python \\PATH\\TO\\main.py --storage-path \\PATH\\TO\\logs\\

⚙️ Конфигурация

Конфигурация MCP для запуска инструмента winlog-mcp.

{ "mcpServers": { "winlog-mcp": { "command": "python", "args": [ "\\PATH\\TO\\main.py", "--storage-path", "\\PATH\\TO\\logs\\" ] } } }

🤖 Интеграция клиентов MCP

💬 Интеграция с рабочим столом Клода

Файл конфигурации находится по адресу:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

После интеграции с Claude Desktop вы можете попросить Claude:

Пожалуйста, покажите мне последние 10 событий за последние 24 часа и проанализируйте их.

📄 Лицензия

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

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Предоставляет программный доступ для приема и запроса журналов событий Windows (особенно журналов Sysmon), позволяя осуществлять мониторинг безопасности, реагирование на инциденты и автоматизировать анализ журналов.

  1. ✨ Особенности
    1. 📄 Формат лог-файлов
  2. MCP-сервер (инструмент, подсказки,...)
    1. 🛠️ Доступные инструменты
  3. 📋 Требования
    1. 💾 Установка
      1. 🚀 Использование
        1. 🖥️ Установка Sysmon
        2. ▶️ Прямой запуск
        3. 🧑‍💻 Режим разработки
      2. ⚙️ Конфигурация
        1. 🤖 Интеграция клиентов MCP
      3. 📄 Лицензия

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          A comprehensive system that helps organizations track, manage, and respond to security vulnerabilities effectively through features like vulnerability tracking, user management, support tickets, API key management, and SSL certificate management.
          Last updated -
          Python
          MIT License
        • A
          security
          A
          license
          A
          quality
          Enables LLMs to query and analyze logs from SEQ structured logging server with capabilities for searching events, retrieving event details, analyzing log patterns, and accessing saved searches.
          Last updated -
          5
          JavaScript
          MIT License
          • Apple
        • -
          security
          F
          license
          -
          quality
          Allows external tools (VSCode, Claude Code, etc.) to access log output and errors, execute commands asynchronously, and monitor process status.
          Last updated -
          3
          Go
          • Linux
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/XD3an/winlog-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server