mcp-server-doctor · packages

A CLI that runs a full diagnostic suite against an MCP server endpoint, compares reports to detect regressions, or continuously monitors an endpoint for grade drops. It ships the `doctor` and `mcp-server-doctor` binaries.

An MCP transport client that auto-negotiates between stdio, SSE, and streamable HTTP transports, providing a `createDoctorClient` factory function that returns an `MCPClient` interface with `connect`, `disconnect`, `listTools`, `callTool`, `sendRequest`, `getSessionId`, and `getServerInfo` methods.

Shared domain types, Zod schemas, grading benchmarks, and utility functions for the `@reaatech/mcp-server-doctor-*` diagnostic ecosystem, exporting TypeScript types (`DiagnosticReport`, `CheckResult`, `LatencyMetrics`), enums (`CheckCategory`, `Severity`, `Grade`), grading functions (`gradeCompliance`, `gradeLatency`, `computeOverallGrade`), and helpers (`generateUUID`, `percentile`, `calculateStats`).

A diagnostic engine that runs 8 health checks against an MCP server, computes a composite A–F grade, and produces a structured `DiagnosticReport`. Exports a `DiagnosticEngine` class with a `run()` method, plus individual check classes that implement a `validate(client, context)` interface.

A Pino-based structured logger and OpenTelemetry metrics/tracing module for MCP server diagnostics, exporting a singleton `logger`, metric recording functions (`recordCheck`, `recordLatency`, `recordGrade`), and a `startSpan` tracer.

A single dispatch function `formatReport(report, format)` that formats a `DiagnosticReport` object into console, JSON, markdown, or HTML output, with individual formatters also exported for direct use.