profiler-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
profiler-mcp
English | 한국어
An MCP server that measures where a running C++ process spends its time: the functions using CPU, time spent waiting, and GPU usage, aggregated down to the function level with PDBs. The target program does not need to be modified or restarted. Tools for Unreal Engine are included.
Requirements
Item | Install |
Windows 10 or later (64-bit) | — |
uv |
|
msdia140.dll | Visual Studio's "Desktop development with C++" workload |
Very Sleepy (optional) |
|
Unreal Engine (optional) | The |
Related MCP server: wpa-mcp
Install (Claude Code plugin)
/plugin marketplace add Lagooneng/profiler-mcp
/plugin install profiler-mcp@profiler-marketplaceWhat to measure with
What you want to know | Use |
What is heavy right now, quickly |
|
How many ms, and how much a fix saved |
|
Which thread is busy |
|
What it is waiting on |
|
Whether the GPU is the bottleneck |
|
When frames hitch |
|
Unreal: engine scopes, frames, render passes |
|
quick_samplesamples one thread for a few seconds without administrator rights. The target slows down noticeably while it runs, so use only the ratios and ranking. It works by running Very Sleepy (GPL-2.0) and reading its result file. Because of that license, this repository does not include its executable or code; it uses the copy you install yourself.capture_start/capture_stoprecord the whole system with ETW. A UAC prompt appears once for start and once for stop.For Unreal projects, Unreal Insights traces (the
ue_tools) are the default. They need no administrator rights.
Tools
Tool | What it does |
| Tool paths, capture in progress, storage |
| Start an ETW capture · stop and save · discard |
| Sample one thread without administrator rights |
| Manage saved traces |
| CPU usage per process · per thread |
| Capture quality (stack coverage, modules that had PDBs) |
| Time per function, call relationships |
| Per-function change between two captures |
| Waiting time by reason · by the thread that woke it |
| Frame presentation intervals, GPU usage per process |
| Record and manage Insights traces |
| Frame times, thread list |
| Time per engine scope (CPU threads, GPU queues) |
| Where an ETW capture and an Insights trace overlap |
The profile-report skill is installed with the plugin: the format for reporting
results and the checks to run before reporting.
Good to know
The UAC prompt shows "Windows Performance Recorder". Any other name is not a prompt from this server.
An ETW capture records the whole system. The trace contains the names and stacks of other processes. Take care when sharing the file.
A capture keeps running independently of this server. Once started, stop it or cancel it.
Modules without a PDB are grouped as
[module name]. Symbols for the kernel and Windows system DLLs are not supported.Storage: a single capture overwrites its oldest part at 10 GB, and when saved traces exceed 20 GB in total the least recently used are deleted.
Environment variables
Variable | Meaning |
| Where traces and PDB copies are kept (default |
| Size cap for a single capture (default |
| Cap on the total size of saved traces (default |
| Folders of PDBs that are never rebuilt (separated by |
| Paths to tools that are not found in their default location |
|
|
Tests
uv run python tests\test_units.py
uv run python tests\test_mcp_e2e.py <process name> [trace name] [--capture]
uv run python tests\test_unreal_insights.py [trace name]--capture runs a real capture, so the UAC prompt appears twice.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read-only server insight: why a Linux server or K8s cluster is slow, failing or changed.
Privacy-first work tracking with summaries, reports, coaching, and AI-ready long-term memory.
Production runtime data for Android and KMP apps (startup, ANRs, slow screens) for coding agents
Investigate errors, track deployments, analyze performance, and manage application monitoring
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables GPU profiling and performance analysis via NVIDIA Nsight Systems, allowing agents to profile binaries and aggregate statistics for kernels, memory copies, and NVTX ranges. It supports advanced analysis through interval tree construction and structural queries on profiling reports.5MIT
- AlicenseNot gradedqualityDmaintenanceMCP server analyzing Windows ETW (.etl) traces — 54 tools spanning CPU/wait stacks, image-load gaps, file/disk/mmap I/O, VirtualAlloc, network, registry, ALPC, DPC/ISR, CLR (GC/JIT/alloc/exception/contention), NT heap, and any user-mode ETW provider. Domain-neutral; works on any Windows trace.18Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to analyze Windows WPR/ETW traces (.etl files) using natural language queries, with features like auto-summary, CPU sampling, DPC/ISR analysis, and symbol resolution.14MIT
- AlicenseBqualityCmaintenanceEnables analysis of Microsoft PIX GPU and timing captures, including event inspection, counter queries, resource views, pipeline state, and GPU timing through an MCP interface.67MIT