ETLReader 2.0.2

ETLReader

An MCP server for analyzing .NET ETL performance traces. Load traces, prepare them, and query CPU stacks, CLR events, file I/O, memory, and any ETW provider — all through a conversational agent.

How It Works

ETLReader runs as a stdio MCP server. An LLM agent (GitHub Copilot, Claude, etc.) connects and drives the investigation:

1. load_traces    → Load a .etl.zip or raw .etl file into a session
2. prepare_etl    → Extract the ETL binary and build an ETLX index (async, agent polls)
3. Analysis tools → Query CPU stacks, allocations, I/O, etc.

The ETL binary (~700MB) is extracted lazily. The ETLX index is cached so subsequent loads are instant. Symbols are resolved from bundled PDBs + Microsoft symbol server.

Tools (9)

Session Management

Analysis

All analysis tools support filtering by process name/ID and time range.

Project Structure

src/
├── Program.cs              Entry point — MCP server bootstrap
├── Session/
│   ├── TraceSession.cs     Session state (baseline/target)
│   └── TracePackage.cs     Single trace lifecycle (extraction, state)
├── Analysis/
│   └── EtlAnalyzer.cs     TraceEvent wrapper — all ETL queries
└── Tools/
    ├── SessionTools.cs     load_traces, session_status, prepare_etl
    └── AnalysisTools.cs    list_processes, get_cpu_stacks, get_clr_data, etc.

Build

dotnet build

Or use the build script to produce a .nupkg:

.\build.ps1

Output goes to package/ETLReader.1.0.0.nupkg.

Run Locally

dotnet run --project src

Or configure in .vscode/mcp.json:

{
  "servers": {
    "ETLReader": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "C:/path/to/ETLReader/src"]
    }
  }
}

Publish to NuGet

.\build.ps1
dotnet nuget push package\ETLReader.1.0.0.nupkg --api-key <KEY> --source https://api.nuget.org/v3/index.json

Once published, users install with:

dotnet tool install -g ETLReader

And configure in their MCP settings:

{
  "servers": {
    "ETLReader": {
      "type": "stdio",
      "command": "dnx",
      "args": ["ETLReader@2.0.1", "--source", "https://api.nuget.org/v3/index.json", "--yes"]
    }
  }
}

Dependencies

Requirements

• .NET 10
• Windows (ETL is a Windows trace format; TraceEvent can parse on any OS but traces are collected on Windows)