# cleggypdc/windows-eventlog-mcpb architecture

> Architecture diagram of the GitHub repository cleggypdc/windows-eventlog-mcpb, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cleggypdc/windows-eventlog-mcpb
- Repository: https://github.com/cleggypdc/windows-eventlog-mcpb

## Overview

This is a Claude Desktop MCP extension for querying Windows Event Logs and returning event data for plain-language diagnosis. The documented workflow is: Claude selects a tool, the PowerShell server queries an allowed log, and the returned JSON becomes part of the Claude conversation. The README documents four distinct query capabilities and the Anthropic data flow; source excerpts were unavailable, so internal handler routing and implementation details are not asserted.

Main entry points: [`server/server.ps1`](https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1) (MCP PowerShell server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tools["Event query tools"]
  node_since_boot["Events since boot<br/>[server.ps1]"]
  node_recent["Recent events<br/>[server.ps1]"]
  node_top_sources["Top event sources<br/>[server.ps1]"]
  node_detail["Event detail<br/>[server.ps1]"]
end

subgraph group_runtime["PowerShell runtime"]
  node_server["MCP PowerShell server<br/>[server.ps1]"]
end

subgraph group_external["External systems"]
  node_claude["Claude Desktop"]
  node_event_logs[("Windows Event Logs")]
  node_anthropic["Anthropic API"]
end

node_user(("User"))

node_user -->|"asks questions"| node_claude
node_claude -->|"calls tool"| node_since_boot
node_claude -->|"calls tool"| node_recent
node_claude -->|"calls tool"| node_top_sources
node_claude -->|"calls tool"| node_detail
node_server -->|"queries"| node_event_logs
node_claude -->|"sends conversation"| node_anthropic

click node_since_boot "https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1"
click node_recent "https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1"
click node_top_sources "https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1"
click node_detail "https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1"
click node_server "https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_since_boot,node_recent,node_top_sources,node_detail,node_user toneBlue
class node_server toneAmber
class node_claude,node_event_logs,node_anthropic toneMint
```

## Components

### Event query tools

- [Events since boot](https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1): `server/server.ps1`
- [Recent events](https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1): `server/server.ps1`
- [Top event sources](https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1): `server/server.ps1`
- [Event detail](https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1): `server/server.ps1`

### PowerShell runtime

- [MCP PowerShell server](https://github.com/cleggypdc/windows-eventlog-mcpb/blob/main/server/server.ps1): `server/server.ps1`

### External systems

- **Claude Desktop**
- **Windows Event Logs**
- **Anthropic API**

### Other components

- **User**

## Connections

- User → Claude Desktop: asks questions (evidence: `README.md`)
- Claude Desktop → Events since boot: calls tool (evidence: `README.md`)
- Claude Desktop → Recent events: calls tool (evidence: `README.md`)
- Claude Desktop → Top event sources: calls tool (evidence: `README.md`)
- Claude Desktop → Event detail: calls tool (evidence: `README.md`)
- MCP PowerShell server → Windows Event Logs: queries (evidence: `README.md`)
- Claude Desktop → Anthropic API: sends conversation (evidence: `README.md`)
