Ez Tools Mcp Server

by heejung0

276 downloads Not rated yet
GitHub

About

EZ Tools MCP Server는 Eric Zimmerman's Tools에서 제공되는 도구들을 Model Context Protocol (MCP) 서버 형태로 노출합니다. 이를 통해 Cursor, Claude Desktop 등 MCP 클라이언트에서 Windows Artifact(Prefetch, EventLog, Registry) 를 분석할 수 있습니다. (Eric Zimmerman's Tool의 특성상 Windows 환경에서만 사용 가능합니다.)

Explore

- Exposes eight forensic analysis tools as MCP tools
- Parse Prefetch files individually or by folder
- Parse Windows Event Log files individually or by folder
- Perform full Registry hive analysis using DFIRBatch
- Run specific Registry batch or hive file analysis
- List available RECmd batch examples
- Includes a health check tool to verify binary installation
- Works exclusively on Windows

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Ez Tools Mcp Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, create a Python virtual environment, and install dependencies. Download the required Eric Zimmerman executables (PECmd, EvtxECmd, RECmd). Then configure your MCP client with a command pointing to the Python interpreter and the server script, and set environment variables (PECMD_EXE, EVTX_EXE, RECMD_EXE) to the executable paths.

ez_tools_healthcheck

Eric Zimmerman's Tools 바이너리 설치 상태 점검

prefetch_dir_parser

Prefetch 파일이 들어있는 폴더 분석

prefetch_file_parser

Prefetch 파일 분석

eventlog_dir_parser

Windows Eventlog 파일이 들어있는 폴더 분석

eventlog_file_parser

Windows Eventlog 파일 분석

registry_total_parser

DFIRBatch.reb 배치 파일을 사용하여 Registy 하이브 전체 분석

registry_plugin_parser

특정 Batch 파일 또는 하이브 파일 개별 분석

list_batches

RECmd BatchExamples 폴더 내에 있는 배치 파일 목록 조회

- ez_tools_healthcheck : Eric Zimmerman's Tools 바이너리 설치 상태 점검
- prefetch_dir_parser : Prefetch 파일이 들어있는 폴더 분석
- prefetch_file_parser : Prefetch 파일 분석
- eventlog_dir_parser : Windows Eventlog 파일이 들어있는 폴더 분석
- eventlog_file_parser : Windows Eventlog 파일 분석
- registry_total_parser : DFIRBatch.reb 배치 파일을 사용하여 Registy 하이브 전체 분석
- registry_plugin_parser : 특정 Batch 파일 또는 하이브 파일 개별 분석
- list_batches : RECmd BatchExamples 폴더 내에 있는 배치 파일 목록 조회

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ez tools mcp server": {
            "ez-tools-MCP": {
                "command": "/path/to/.venv/Scripts/python",
                "args": [
                    "/path/to/EZ_tools_mcp_server.py"
                ],
                "env": {
                    "PECMD_EXE": "/path/to/PECmd.exe",
                    "EVTX_EXE": "/path/to/EvtxECmd.exe",
                    "RECMD_EXE": "/path/to/RECmd.exe"
                }
            }
        }
    }
}

McpServers

{
    "ez-tools-MCP": {
        "command": "/path/to/.venv/Scripts/python",
        "args": [
            "/path/to/EZ_tools_mcp_server.py"
        ],
        "env": {
            "PECMD_EXE": "/path/to/PECmd.exe",
            "EVTX_EXE": "/path/to/EvtxECmd.exe",
            "RECMD_EXE": "/path/to/RECmd.exe"
        }
    }
}
EZ Tools MCP Server는 Eric Zimmerman's Tools에서 제공되는 도구들을 Model Context Protocol (MCP) 서버 형태로 노출합니다. 이를 통해 Cursor, Claude Desktop 등 MCP 클라이언트에서 Windows Artifact(Prefetch, EventLog, Registry) 를 분석할 수 있습니다. _(Eric Zimmerman's Tool의 특성상 Windows 환경에서만 사용 가능합니다.)_

Tools

- ez_tools_healthcheck : Eric Zimmerman's Tools 바이너리 설치 상태 점검 - prefetch_dir_parser : Prefetch 파일이 들어있는 폴더 분석 - prefetch_file_parser : Prefetch 파일 분석 - eventlog_dir_parser : Windows Eventlog 파일이 들어있는 폴더 분석 - eventlog_file_parser : Windows Eventlog 파일 분석 - registry_total_parser : DFIRBatch.reb 배치 파일을 사용하여 Registy 하이브 전체 분석 - registry_plugin_parser : 특정 Batch 파일 또는 하이브 파일 개별 분석 - list_batches : RECmd BatchExamples 폴더 내에 있는 배치 파일 목록 조회

Installation

1. Python 환경 준비

``bash git clone https://github.com/heejung0/EZ-tools-mcp-server.git cd EZ-tools-mcp-server python -m venv .venv source .venv/bin/activate pip install -r requirements.txt `

2. Eric Zimmerman's Tools 설치

- PECmd : https://download.ericzimmermanstools.com/net9/PECmd.zip - EvtxECmd : https://download.ericzimmermanstools.com/net9/EvtxECmd.zip - RECmd : https://download.ericzimmermanstools.com/net9/RECmd.zip

3. MCP Client 연결

- Windows
`json { "mcpServers": { "ez-tools-MCP": { "command": "/path/to/.venv/Scripts/python", "args": [ "/path/to/EZ_tools_mcp_server.py" ], "env": { "PECMD_EXE": "/path/to/PECmd.exe", "EVTX_EXE": "/path/to/EvtxECmd.exe", "RECMD_EXE": "/path/to/RECmd.exe" } } } } ``
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.