mcp-server-starter-ts · packages

Express middleware that validates incoming MCP server requests via API key or Bearer token using constant-time comparison, with an automatic dev-mode bypass when no key is configured.

Provides shared Zod schemas, domain types (`ToolResponse`, `ContentBlock`, `RequestContext`), validated environment configuration, and content block factories for the `@reaatech/mcp-server-*` ecosystem. Exports TypeScript types and runtime validation helpers, with no runtime dependencies beyond Zod.

An Express 5-based MCP server framework that provides a composable middleware pipeline (auth, rate limiting, idempotency, sanitization), dual transport support (Streamable HTTP + SSE), automatic tool discovery and orchestration, health endpoints, OpenTelemetry tracing, and graceful shutdown. Exports `createApp()` (returns a configured Express app) and `startServer()` (listens on PORT with shutdown handlers).

Provides structured logging (Pino-based with PII redaction), OpenTelemetry tracing with OTLP export, and Prometheus-compatible metrics for MCP servers, exporting a logger, `initObservability()`, `withSpan()`, and metric recording functions.

A type-safe tool registry and discovery system for MCP servers, providing a `defineTool()` helper with Zod input schemas, an in-memory registry with `registerTool`/`getTools`/`getTool`/`clearTools`, filesystem auto-discovery of `.tool.ts` files, and built-in `echo` and `health-check` tools.

Mounts MCP transport handlers (Streamable HTTP and SSE) onto an Express or Fastify application, managing session lifecycle, automatic cleanup, and transport-level metrics. Exports `mountStreamableHTTP`, `mountSSE`, and Fastify plugin functions that accept a server factory and optional path configuration.