HE

hexastrike/eventwhisper

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

56 stars 7 forks 质量 61 趋势 14GPL-3.0

一个Windows事件日志MCP

概览

通过MCP(模型上下文协议)服务器,提供快速且可脚本化的Windows日志访问。它纯粹是Python(使用evtx库),而非PowerShell包装器,且不在主机上执行命令——更适合事件响应、数字取证和威胁狩猎。 - 为任意目录列出EVTX文件(可选递归)。- 过滤事件以直接搜索特定记录。 专为红外/DFIR和狩猎设计,不用整天查事件ID。设计、开发并测试于Windows上,使用Claude——可在任何MCP客户端使用。 - : 时间窗口、EventID(s)和大小写不区分的关键词(包含/排除) - : 只返回你需要的虚点路径(输出大幅减少)- : 接受灵活的输入格式,即使类型/格式不完美也能正常使用。- : 插入 Claude Desktop(及其他 MCP 客户端) https://github.

概述(AI 翻译)

EventWhisper 通过 MCP(模型上下文协议)服务器,快速、可脚本化访问 Windows .evtx 日志。 它纯粹是Python(使用evtx库),而不是PowerShell封装器,并且不在主机上执行命令——更适合事件响应、数字取证和威胁狩猎。

服务器提供两个主要工具:

  • 为任意目录列出EVTX文件(可选递归)。
  • 通过筛选事件直接搜索特定记录。

专为红外/DFIR和狩猎设计,不用整天查事件ID。设计、开发并测试于Windows上,使用Claude——可在任何MCP客户端使用。


特色

  • 定向过滤:时间窗口、事件ID和大小写不区分的关键词(包含/排除)
  • 场投影:只返回你需要的虚线路径(输出大幅减少)
  • 输入规范化:接受灵活的输入格式,因此即使类型/格式不完美也能正常工作。
  • MCP 支持:可插入 Claude Desktop(及其他 MCP 客户端)

演示

https://github.com/user-attachments/assets/e1878c86-56f6-466b-bbc4-04d1edeeb36b


需求(Windows)

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

EventWhisper — A Windows Event Log MCP

EventWhisper exposes fast, scriptable access to Windows .evtx logs via an MCP (Model Context Protocol) server. It’s pure Python (uses the evtx library), instead of a PowerShell wrapper and does not execute commands on the host — safer for incident response, digital forensics, and threat hunting.

The server exposes two primary tools:

  • List EVTX files (optionally recursive) for any directory.
  • Filter events to directly search for specific records.

Built specifically for IR/DFIR & hunting so you don’t need to look up Event IDs all day. Designed, developed, and tested on Windows with Claude — and usable from any MCP client.


Features

  • Targeted filtering: time window, EventID(s), and case-insensitive keywords (include/exclude)
  • Field projection: return only the dotted paths you need (huge output reduction)
  • Input normalization: accepts flexible input formats so it still works if types/format aren’t perfect.
  • MCP-ready: plugs into Claude Desktop (and other MCP clients)

Demo

https://github.com/user-attachments/assets/e1878c86-56f6-466b-bbc4-04d1edeeb36b


Requirements (Windows)

EventWhisper can be set up with Poetry, whether you run it inside Claude or standalone. On Windows, make sure Poetry is on your PATH.

Install Poetry (PowerShell):

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

Add Poetry to PATH (user install):

C:\Users\\AppData\Roaming\Python\Scripts

Verify:

poetry --version

Install & Run

Primarily developed for use with Claude, but you can run the MCP server standalone and plug it into other LLMs.

Clone and install:

git clone https://github.com/hexastrike/eventwhisper
cd eventwhisper
poetry install

Run the MCP server:

poetry run python -m eventwhisper.mcp.server
# (or) plain Python if deps are installed globally:
python -m eventwhisper.mcp.server

Claude MCP configuration

Add this to Claude Desktop’s MCP config (e.g., %AppData%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "EventWhisper": {
      "type": "stdio",
      "command": "poetry",
      "args": [
        "-C",
        "C:\\Path\\To\\eventwhisper",
        "run",
        "python",
        "-m",
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "EventWhisper": { "type": "stdio", "command": "poetry", "args": [ "-C", "C:\\Path\\To\\eventwhisper", "run", "python", "-m", "eventwhisper.mcp.server" ], "env": { "PYTHONIOENCODING": "utf-8" } } } }