Skip to content
reaatechREAATECH

reaatech/mcp-server-doctor

0Last commit: May 19, 2026GitHub →

These packages give you a CLI tool and programmatic library that runs eight health checks against any MCP server endpoint, grades the results A–F, and outputs reports in console, JSON, markdown, or HTML formats. You would adopt them to catch MCP server issues before deployment—transport negotiation failures, latency spikes, auth problems, or concurrency limits—and to enforce quality gates in CI. The engine, transport client, reporters, and observability instrumentation are separate packages that share core types and grading logic, so you can use just the CLI or compose the pieces programmatically (for example, running the engine with a custom transport and piping results into your own monitoring pipeline).

Packages

6 packages

@reaatech/mcp-server-doctor-cli

v1.0.0
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.
status
published
published
8 days ago

@reaatech/mcp-server-doctor-client

v1.0.0
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.
status
published
published
8 days ago

@reaatech/mcp-server-doctor-core

v1.0.0
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`).
status
published
published
8 days ago

@reaatech/mcp-server-doctor-engine

v1.0.0
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.
status
published
published
8 days ago

@reaatech/mcp-server-doctor-observability

v1.0.0
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.
status
published
published
8 days ago

@reaatech/mcp-server-doctor-reporters

v1.0.0
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.
status
published
published
8 days ago

Comments

Sign in with GitHub to comment and vote.

Loading comments…