Skip to main content
Glama

procmon-mcp

Python 3.10+ License: MIT CI

An MCP server that gives AI assistants deep visibility into Windows internals: processes, ETW kernel traces, event logs, services, drivers, minifilters, and static PE analysis. Built for security researchers, reverse engineers, and anyone who wants an LLM that can actually see what Windows is doing.

This is a proof of concept (POC). Use at your own risk.

procmon-mcp interacts directly with sensitive Windows internals: kernel ETW traces, process memory, security event logs, service/driver enumeration, and UAC elevation requests. These operations can affect system stability, expose sensitive data, and require administrator privileges. There are no guardrails beyond what Windows itself enforces. Review the tool list, understand what each tool does, and run this only in environments you control. The authors assume no liability for misuse or unintended consequences.

Why?

LLMs are blind to what your OS is doing. Every time you need process info, network connections, or trace data, you're alt-tabbing to Task Manager, Process Monitor, or PowerShell and pasting results back. procmon-mcp eliminates that loop -- your AI assistant can directly query 18 tools covering live process state, kernel ETW traces, PE internals, event logs, services, drivers, and minifilters. Ask a question, get structured data, stay in flow.

Related MCP server: windows-admin-mcp

Quickstart

pip install procmon-mcp

Or run without installing:

uvx procmon-mcp

Example prompts

Once connected, try asking your AI assistant:

  • "What processes are making network connections right now?"

  • "Start an ETW trace, launch notepad, stop the trace, and show me what happened"

  • "Analyze the PE imports of C:\Windows\System32\cmd.exe and categorize the APIs"

  • "Are any non-Microsoft services running? Show me their binary paths"

  • "Show me recent logon events from the Security log"

  • "Take a 30-second timed capture of all svchost processes and summarize the changes"

  • "List all minifilter drivers and their altitudes"

  • "What AV products does SecurityCenter2 report?"

Features

  • Processes -- list, detailed metadata (modules, threads, command line, memory), point-in-time snapshots, timed multi-snapshots with optional trigger commands

  • ETW -- start/stop kernel traces with logman and tracerpt, list providers, preview CSV and summary output

  • Network -- TCP and UDP endpoint enumeration with owning process filters

  • Services and drivers -- service listing with binary paths, kernel driver enumeration, fltmc minifilter output

  • PE analysis -- static import/export extraction with API category tags (Kernel API, Native API, Win32, Driver)

  • Event logs -- Get-WinEvent queries and a Security log convenience wrapper for audit event IDs (4688, 4624, 4672, 4648)

  • System -- OS build, AV product snapshot, elevation capability matrix, UAC helper

  • Presets -- Defender process/service/driver constants and scan trigger helpers

How it compares

procmon-mcp is the most comprehensive live Windows monitoring MCP server available. With 18 tools spanning processes, ETW kernel tracing, PE analysis, event logs, services, drivers, and minifilters, it covers more ground than any other single MCP server for live Windows internals. Other tools in this space either focus narrowly (process listing only, event logs only) or do offline forensics from Linux. procmon-mcp gives your AI assistant direct, real-time access to the full Windows instrumentation stack.

MCP client configuration

Cursor

Add to your MCP settings (.cursor/mcp.json or global settings):

{
  "mcpServers": {
    "procmon-mcp": {
      "command": "procmon-mcp",
      "args": []
    }
  }
}

If you installed into a virtual environment, use python -m procmon_mcp:

{
  "mcpServers": {
    "procmon-mcp": {
      "command": "python",
      "args": ["-m", "procmon_mcp"],
      "cwd": "C:\\path\\to\\your\\venv\\Scripts"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "procmon-mcp": {
      "command": "procmon-mcp",
      "args": []
    }
  }
}

Tool reference

Tool

Description

Required parameters

list_processes

Processes with optional name/PID filter

none

get_process_details

Modules, threads, command line, memory

none

capture_snapshot

Point-in-time process, module, and network snapshot

none

timed_capture

Repeated snapshots over a duration

none

start_etw_trace

Start a kernel ETW trace (requires elevation)

session_name

stop_etw_trace

Stop trace and convert ETL output

session_name

list_etw_providers

Parse logman query providers

none

get_network_connections

TCP/UDP endpoints by process

none

list_services

Win32 services with paths

none

list_drivers

Kernel drivers via WMI

none

get_minifilters

fltmc filter and instance output

none

analyze_pe

Static PE imports and exports

file_path

find_pe_files

Recursive PE file discovery

directory

query_event_log

Get-WinEvent FilterHashtable query

none

get_security_events

Security log (IDs 4688, 4624, 4672, 4648)

none

get_system_info

OS build and AV snapshot

none

check_elevation

Capability matrix

none

request_elevation

UAC helper for a shell command

command

All tools accept optional parameters beyond those listed. See tool schemas for details.

Elevation

Several capabilities require an elevated (administrator) token:

  • start_etw_trace and stop_etw_trace use logman real-time sessions (-ets).

  • get_security_events reads the Security log.

Other tools run without elevation but may return partial results when Windows blocks enumeration (protected processes, restricted logs). Use check_elevation for the full capability matrix.

Presets

The Defender preset (procmon_mcp.presets.defender) provides constants (DEFENDER_PROCESSES, DEFENDER_SERVICES, DEFENDER_DRIVERS), binary discovery, MpCmdRun resolution, trigger_scan, and get_preset_config. MCP tools stay generic and preset-agnostic.

Development

pip install -e ".[dev]"
ruff check .
pytest

See CONTRIBUTING.md for full guidelines.

Security

This is a POC. The operations performed are sensitive by nature. This tool reads process memory, enumerates kernel drivers, starts ETW trace sessions, queries security audit logs, and can trigger UAC elevation prompts. Run it only on machines you own or have explicit authorization to instrument. Never point it at production systems without understanding the implications. See SECURITY.md for our security policy and responsible disclosure process.

License

MIT. See LICENSE.

Available Tools

18 tools
analyze_peC

Parse a PE file with pefile: imports, exports, category summary.

Inputs: file_path (required).

capture_snapshotC

Point-in-time snapshot of matching processes: processes, modules, network connections.

Inputs: process_names, pids.

check_elevationA

Whether the server is elevated plus a capability matrix for all tools.

Inputs: no named parameters.

find_pe_filesB

Recursively discover PE files under a directory.

Inputs: directory (required), extensions.

get_minifiltersB

Run fltmc filters and instances and return raw parsed lines.

Inputs: no named parameters.

get_network_connectionsC

TCP and/or UDP endpoints with owning process. protocol: tcp, udp, both, all.

Inputs: process_name, pid, protocol.

get_process_detailsA

Deep process details: modules, handle count, threads, command line, memory breakdown. May warn on protected processes.

Inputs: pid, name.

get_security_eventsB

Security log convenience: IDs 4688, 4624, 4672, 4648 (requires elevation).

Inputs: max_events, hours_back.

get_system_infoB

OS build, architecture, hostname, SecurityCenter2 AV products, PowerShell version.

Inputs: no named parameters.

list_driversC

Enumerate kernel drivers via Win32_SystemDriver.

Inputs: name_filter.

list_etw_providersC

Parse logman query providers with optional keyword filter.

Inputs: keyword.

list_processesA

List processes with optional name or PID filter. Returns handles, threads, working set, path, parent PID, start time.

Inputs: name_filter, pid_filter.

list_servicesA

Enumerate services via Win32_Service (name, state, start mode, display name, path).

Inputs: name_filter, status_filter.

query_event_logC

Query a Windows event log via Get-WinEvent FilterHashtable.

Inputs: log_name, event_ids, max_events, hours_back, +1 more.

request_elevationC

Launch a cmd script via UAC (Start-Process -Verb RunAs) to run the given command.

Inputs: command (required), timeout.

start_etw_traceA

Start a kernel ETW trace via logman (requires elevation). providers are Microsoft-Windows-Kernel-* names or GUID strings.

Inputs: session_name (required), providers, output_dir.

stop_etw_traceA

Stop ETW trace, run tracerpt to CSV and summary, return parsed preview (requires elevation).

Inputs: session_name (required), output_dir, process_filter.

timed_captureA

Repeated snapshots over a duration with optional shell trigger command launched at start.

Inputs: process_names, duration, interval, trigger_command.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 18 tools

    Disambiguation4/5

    Most tools have distinct purposes, but capture_snapshot bundles process listing and network connections that overlap with list_processes and get_network_connections. However, descriptions clarify the composite nature, reducing ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (e.g., analyze_pe, list_processes, start_etw_trace), with no mixing of conventions.

    Tool Count4/5

    18 tools cover a broad monitoring domain, slightly exceeding the typical 3-15 range, but each tool addresses a specific need, and no tool feels redundant.

    Completeness5/5

    The tool set covers core process monitoring aspects: process listing, deep details, network, security events, ETW tracing, services, drivers, PE analysis, and elevation handling. There are no obvious gaps for its intended scope.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A MCP server for Windows/Linux that provides 90+ tools enabling AI assistants to systematically manage local systems, including system probing, command execution, file editing, network diagnostics, and more.
      13
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI assistants to manage, monitor, and diagnose Windows systems through 42 tools across 8 modules, including services, event viewer, task scheduler, processes, network, diagnostics, observability, and safety features.
      16 npm
      9
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that exposes dynamic binary instrumentation, memory editing, pointer scanning, and scripting capabilities to AI agents, enabling real-time process inspection and modification.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An open-source MCP server for Windows that provides traceable system operations (file, screenshot, clipboard, process, power management) to AI assistants via HTTP/SSE.
      14
      GPL 3.0