Diag Session MCP

诊断会话MCP服务器

用于分析.diagsession存档中的Windows ETL跟踪文件的生产级模型上下文协议（MCP）服务器。基于干净的架构原则和企业最佳实践构建。

特性

• ETL跟踪分析：使用CPU采样数据分析Windows性能记录器跟踪
• 呼叫树生成：构建显示包容性/排他性CPU时间的分层调用树
• 符号分辨率：与Microsoft符号服务器集成，用于函数名称解析
• .diagsession支持：自动从.diagsession ZIP存档中提取ETL文件
• 流程过滤：按特定进程ID筛选分析
• 深度控制：限制调用树深度以实现高效响应
• MCP协议：通过标准MCP工具界面显示分析

建筑

服务器遵循严格分离关注点的分层架构：

┌─────────────────────────────────────┐
│      MCP Protocol Layer             │  Tool handlers, schemas
├─────────────────────────────────────┤
│      Application Layer              │  Use cases, DTOs
├─────────────────────────────────────┤
│      Domain Layer                   │  Business logic, models
├─────────────────────────────────────┤
│      Infrastructure Layer           │  TraceEvent adapter, ZIP extraction
└─────────────────────────────────────┘

关键组件

• 领域模型: CallTreeNode, FunctionStats, AnalysisResult, AnalysisOptions
• 域接口: IEtlAnalyzer, IDiagSessionExtractor
• 应用: AnalyzeDiagSessionUseCaseDTO， RequestContext
• 基础设施: TraceEventEtlAnalyzer, DiagSessionArchiveExtractor
• 主控程序: AnalyzeCallTreeTool

安装

先决条件

• .NET 8.0 SDK或更高版本
• Windows操作系统（TraceEvent库需要）

构建

dotnet restore
dotnet build

跑

dotnet run --project DiagSession-Mcp.csproj

服务器将启动并通过stdio传输监听MCP请求。

MCP工具：analyze_call_tree

参数

响应架构

{
  "callTrees": {
    "4036": {
      "functionName": "InterruptEstimator (PID: 4036)",
      "moduleName": null,
      "inclusiveSamples": 246,
      "exclusiveSamples": 0,
      "inclusivePercent": 100.0,
      "exclusivePercent": 0.0,
      "inclusiveTimeMs": 246.0,
      "exclusiveTimeMs": 0.0,
      "children": [...]
    }
  },
  "processNames": {
    "4036": "InterruptEstimator"
  },
  "totalSamples": 246,
  "profileIntervalMs": 1.0,
  "analysisTimestamp": "2025-11-25T07:36:00Z",
  "correlationId": "abc123",
  "topFunctionsByExclusive": [...],
  "topFunctionsByInclusive": [...]
}

错误代码

• FILE_NOT_FOUND：指定的文件不存在
• INVALID_PARAMS：提供的参数无效
• TIMEOUT：分析超时
• INTERNAL_ERROR：意外的服务器错误

配置

配置从加载 appsettings.json 以及环境变量。

应用程序参数

{
  "DiagSessionMcp": {
    "SymbolPath": "srv*c:\\symbols*https://msdl.microsoft.com/download/symbols",
    "DefaultTimeoutSeconds": 30,
    "MaxConcurrentAnalyses": 2,
    "MaxMemoryMB": 4096,
    "AllowedDirectories": ["C:\\DiagSessions"],
    "LogLevel": "Information"
  }
}

环境变量

• _NT_SYMBOL_PATH：覆盖符号服务器路径
• DIAGSESSION_MCP__SYMBOLPATH：通过配置覆盖符号路径

发展

项目结构

DiagSession-Mcp/
├── src/
│   ├── Domain/
│   │   ├── Models/          # Domain entities
│   │   └── Interfaces/      # Domain contracts
│   ├── Application/
│   │   ├── UseCases/        # Application logic
│   │   ├── DTOs/            # Data transfer objects
│   │   └── Common/          # Cross-cutting concerns
│   ├── Infrastructure/
│   │   └── Adapters/        # External system adapters
│   ├── Mcp/
│   │   └── Tools/           # MCP tool implementations
│   └── Program.cs           # Entry point
├── appsettings.json
└── DiagSession-Mcp.csproj

测试

# Run all tests
dotnet test

# Run specific test category
dotnet test --filter Category=Unit
dotnet test --filter Category=Integration

设计原则

此服务器遵循企业架构最佳实践：

• 限界上下文：专注于ETL跟踪分析
• 端口和适配器：接口背后的外部依赖关系
• 领域驱动设计：具有业务逻辑的丰富域模型
• 关注点分离：严格分层，责任明确
• 依赖注入：通过构造函数注入的所有依赖项
• 不变性：DTO和域模型在可能的情况下是不可变的
• 明确合同：对工具模式进行版本控制和记录
• 可观测性：带有关联ID的结构化日志记录
• 错误处理：域错误与技术故障分开
• 可测试性：每一层都可以独立测试

许可证

麻省理工学院

鸣谢

内置：

• 模型上下文协议C#SDK
• 微软。诊断。追踪。追踪事件