Windows Diagnostics MCP Server

Instructions

Implementation Reference

• src/tools/diagnostics.ts:80-138 (handler)

  The core handler function that executes the analyze_system_stability tool. It runs a PowerShell diagnostic script, computes a stability score based on BSOD events, shutdowns, crashes, hardware errors, and uptime, then generates a markdown report with rating, issues, recommendations, and metrics.

  export async function analyzeSystemStability(args: { daysBack?: number }) {
    const daysBack = args?.daysBack || 30;
    const result = await runPowerShellScript(DIAGNOSTIC_SCRIPT, { DaysBack: daysBack, JsonOutput: true }) as AllTypes.DiagnosticResults;
  
    const bsodCount = result.BSODEvents.length;
    const unexpectedShutdowns = result.ShutdownEvents.filter((e: AllTypes.EventInfo) => e.EventID === 6008).length;
    const totalCrashes = result.Summary.TotalApplicationCrashes || 0;
    const hardwareErrors = result.HardwareErrors.length;
  
    let stabilityScore = 100;
    const recommendations: string[] = [];
    const issues: string[] = [];
  
    if (bsodCount > 0) {
      stabilityScore -= bsodCount * 20;
      issues.push(`${bsodCount} BSOD event(s)`);
      recommendations.push('Investigate BSOD causes - check Windows Update for driver updates');
    }
  
    if (unexpectedShutdowns > 0) {
      stabilityScore -= unexpectedShutdowns * 10;
      issues.push(`${unexpectedShutdowns} unexpected shutdown(s)`);
      recommendations.push('Check hardware connections and power supply');
    }
  
    if (totalCrashes > 10) {
      stabilityScore -= Math.min(totalCrashes, 30);
      issues.push(`${totalCrashes} application crashes`);
      recommendations.push('Run system file checker: sfc /scannow');
    }
  
    if (hardwareErrors > 0) {
      stabilityScore -= hardwareErrors * 5;
      issues.push(`${hardwareErrors} hardware error(s)`);
      recommendations.push('Check hardware health and run memory diagnostics');
    }
  
    if (result.SystemInfo.CurrentUptimeDays > 30) {
      stabilityScore -= 5;
      recommendations.push('Reboot system to apply updates and clear memory');
    }
  
    stabilityScore = Math.max(0, stabilityScore);
  
    let stabilityRating: string;
    if (stabilityScore >= 90) stabilityRating = 'Excellent ✅';
    else if (stabilityScore >= 75) stabilityRating = 'Good 👍';
    else if (stabilityScore >= 50) stabilityRating = 'Fair ⚠️';
    else stabilityRating = 'Poor ❌';
  
    return {
      content: [
        {
          type: 'text',
          text: `# System Stability Analysis (Last ${daysBack} days)\n\n## Overall Stability Score: ${stabilityScore}/100 (${stabilityRating})\n\n## Issues Detected\n${issues.length > 0 ? issues.map(issue => `- ${issue}`).join('\n') : '- No major issues detected ✅'}\n\n## Recommendations\n${recommendations.length > 0 ? recommendations.map(rec => `- ${rec}`).join('\n') : '- System appears stable, continue regular maintenance'}\n\n## Key Metrics\n- **BSOD Events**: ${bsodCount}\n- **Unexpected Shutdowns**: ${unexpectedShutdowns}\n- **Application Crashes**: ${totalCrashes}\n- **Hardware Errors**: ${hardwareErrors}\n- **Current Uptime**: ${result.SystemInfo.CurrentUptimeDays} days\n\n## Additional Actions\n- Run DISM health check: \`DISM /Online /Cleanup-Image /RestoreHealth\`\n- Check Windows Update for pending updates\n- Review Event Viewer for additional details\n- Consider hardware diagnostics if issues persist`,
        },
      ],
    };
  }

• src/index.ts:104-117 (schema)

  The input schema definition for the analyze_system_stability tool, registered in the ListTools response. Defines optional daysBack parameter with default 30.

  {
    name: 'analyze_system_stability',
    description: 'Analyze system stability and provide recommendations',
    inputSchema: {
      type: 'object',
      properties: {
        daysBack: {
          type: 'number',
          description: 'Number of days back to analyze (default: 30)',
          default: 30,
        },
      },
    },
  },

• src/index.ts:547-548 (registration)

  The registration/dispatch logic in the CallToolRequestSchema handler's switch statement that routes calls to the analyzeSystemStability function from diagnostics module.

  case 'analyze_system_stability':
    return await diagnostics.analyzeSystemStability(args as { daysBack?: number });