mcp-contract-kit · packages

Validates Model Context Protocol (MCP) servers against protocol, security, and performance standards using a CLI tool and a programmatic API. It provides functions to execute test suites and generate reports in multiple formats, including JSON, Markdown, and HTML.

Provides a client class and factory function for interacting with Model Context Protocol (MCP) servers over HTTP. It handles JSON-RPC 2.0 communication, tool discovery, and tool invocation with built-in support for retries, timeouts, and SSE streaming.

Provides foundational TypeScript interfaces, Zod schemas, and JSON-RPC 2.0 types for validating and interacting with Model Context Protocol (MCP) contracts. It serves as the shared dependency for building custom MCP validators, test suites, and client implementations.

Provides observability utilities for MCP contract validation, including a Pino-based JSON logger with automatic PII redaction, in-memory metrics collection, and W3C trace context propagation. It exports a set of functions and singleton instances for managing structured logs, counters, histograms, and async span lifecycle tracking.

Converts `TestReport` objects from `@reaatech/mcp-contract-core` into console, JSON, Markdown, or HTML strings. It provides a collection of formatting functions and a dispatcher to render contract validation results for terminal output, CI pipelines, or documentation.

Validates Model Context Protocol (MCP) server compliance, security, and performance through a collection of validator functions and suites. It provides individual validator objects and factory functions that accept an MCP client instance to verify protocol adherence, schema integrity, and runtime behavior.