Windows Diagnostics MCP Server

Instructions

Implementation Reference

• src/tools/diagnostics.ts:49-63 (handler)

  Core implementation of the get_bsod_events tool. Executes a PowerShell diagnostic script to retrieve BSOD events from Windows Event Logs and formats them into a markdown response.

  export async function getBSODEvents(args: { daysBack?: number }) {
    const daysBack = args?.daysBack || 7;
    const result = await runPowerShellScript(DIAGNOSTIC_SCRIPT, { DaysBack: daysBack, JsonOutput: true }) as AllTypes.DiagnosticResults;
  
    return {
      content: [
        {
          type: 'text',
          text: `# Blue Screen of Death (BSOD) Events (Last ${daysBack} days)\n\n${result.BSODEvents.length > 0 ? 
  `⚠️ **CRITICAL**: ${result.BSODEvents.length} BSOD event(s) found!\n\n` + result.BSODEvents.map((e: AllTypes.EventInfo) => `- **${e.Time}**: ${e.Description} (Event ID: ${e.EventID}, Source: ${e.Source})\n  Details: ${e.Details.substring(0, 200)}...`).join('\n\n')
  : '✅ No BSOD events found in the specified period.'}`,
        },
      ],
    };
  }

• src/index.ts:82-95 (registration)

  Tool registration in the MCP listTools handler, defining the tool name, description, and input schema.

  {
    name: 'get_bsod_events',
    description: 'Get Blue Screen of Death (BSOD) events',
    inputSchema: {
      type: 'object',
      properties: {
        daysBack: {
          type: 'number',
          description: 'Number of days back to analyze (default: 7)',
          default: 7,
        },
      },
    },
  },

• src/index.ts:543-544 (registration)

  Dispatcher in the MCP callTool handler that routes get_bsod_events calls to the diagnostics module implementation.

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