mcp-server-doctor · packages

Provides a CLI for diagnosing, comparing, and monitoring Model Context Protocol (MCP) server health via stdio, SSE, or HTTP transports. It generates diagnostic reports in multiple formats and supports regression analysis between test runs.

Provides a unified client for connecting to Model Context Protocol (MCP) servers with automatic transport negotiation across stdio, SSE, and HTTP. It exposes a factory function that returns an instance for managing the full MCP lifecycle, including tool discovery, execution, and credential injection.

Provides shared TypeScript types, Zod schemas, and grading logic for building MCP server diagnostic tools. It exports utility functions for calculating latency metrics and compliance scores, requiring only `zod` as a runtime dependency.

Executes a suite of eight diagnostic checks against an MCP server to generate a structured `DiagnosticReport` with a composite A–F grade. It provides a `DiagnosticEngine` class that requires an initialized MCP client to perform latency profiling, schema validation, and concurrency stress testing.

Provides structured logging, OpenTelemetry metrics, and distributed tracing specifically for MCP server diagnostic checks. It exports a singleton Pino logger and a set of helper functions that automatically redact sensitive credentials and remain no-ops unless OpenTelemetry environment variables are configured.

Converts `DiagnosticReport` objects into console, JSON, Markdown, or HTML strings. It provides a `formatReport` dispatch function and individual formatter exports for use with diagnostic data generated by the `mcp-server-doctor` engine.