mcp-server-framework 1.0.0

package/build/server/server-options.d.ts

@@ -0,0 +1,411 @@
+/**
+ * Server Configuration Types
+ *
+ * Types for configuring and building MCP servers.
+ * Provides a clean, declarative API for server setup.
+ *
+ * @module server/server-options
+ */
+import type { ServerLifecycleHooks, ShutdownConfig } from "./lifecycle.js";
+import type { HandlersConfig } from "../mcp/types/index.js";
+import type { ConnectionStateManager } from "../connection/index.js";
+import type { ServiceClient } from "../connection/types.js";
+import type { SessionStore } from "./session/index.js";
+import type { ServerCapabilities } from "../mcp/capabilities/server-capabilities.js";
+import type { TransportOptions } from "./transport-options.js";
+import type { AuthOptions } from "./auth/types.js";
+export { type TransportMode, type TlsConfig, type BaseHttpTransportOptions, type StdioTransportOptions, type HttpTransportOptions, type HttpsTransportOptions, type TransportOptions, isHttpTransport, } from "./transport-options.js";
+export { type ServerCapabilities, DEFAULT_CAPABILITIES } from "../mcp/capabilities/server-capabilities.js";
+/**
+ * Health endpoint configuration for API connectivity monitoring.
+ *
+ * Allows consumers to wire their {@link ConnectionStateManager} to the
+ * `/ready` endpoint so readiness probes reflect the actual API connection state.
+ *
+ * Without this configuration, the `/ready` endpoint reports
+ * `api: { configured: false, state: 'unknown', connected: false }`.
+ *
+ * @example
+ * ```typescript
+ * const server = createServer({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ *   transport: { mode: 'http' },
+ *   health: {
+ *     connectionManager: myConnectionManager,
+ *     isApiConfigured: () => !!process.env.MY_API_URL,
+ *     apiLabel: 'my-api',
+ *   },
+ * });
+ * ```
+ */
+export interface HealthConfig<TService extends ServiceClient = ServiceClient> {
+    /**
+     * Connection state manager for API health checks.
+     * If not provided, API connectivity checks are skipped.
+     */
+    readonly connectionManager?: ConnectionStateManager<TService>;
+    /**
+     * Function to check if the API is configured.
+     * If not provided, defaults to checking for `API_URL` env var.
+     */
+    readonly isApiConfigured?: () => boolean;
+    /**
+     * Label for the API in health responses (e.g., 'my-api', 'docker').
+     * @default 'api'
+     */
+    readonly apiLabel?: string;
+}
+/**
+ * Session configuration options for the programmatic API.
+ *
+ * Allows fine-tuning session lifecycle behavior directly from
+ * `createServer()` or `McpServerBuilder.withOptions()`. All properties
+ * are optional — defaults are resolved from environment variables
+ * and config files via the standard config cascade.
+ *
+ * This is particularly useful for "lightweight stateful" deployments
+ * where short session timeouts are preferred over full stateless mode,
+ * retaining cross-request features (cancellation, sampling, elicitation)
+ * that stateless mode cannot support.
+ *
+ * @example
+ * ```typescript
+ * // Lightweight stateful — short-lived sessions with all MCP features
+ * createServer({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ *   transport: { mode: 'http' },
+ *   session: {
+ *     timeoutMs: 60_000,           // 1 minute instead of default 30 min
+ *     cleanupIntervalMs: 10_000,   // Check every 10s
+ *   },
+ * });
+ *
+ * // Custom session store for horizontal scaling
+ * createServer({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ *   transport: { mode: 'http' },
+ *   session: { store: new RedisSessionStore() },
+ * });
+ * ```
+ *
+ * @see SessionConfig for default values
+ */
+export interface SessionConfigOptions {
+    /**
+     * Session timeout in milliseconds.
+     *
+     * Sessions inactive for longer than this value are cleaned up by the
+     * housekeeper. Lower values create "lightweight" sessions that free
+     * resources faster.
+     *
+     * @default 1_800_000 (30 minutes, from MCP_SESSION_TIMEOUT_MS)
+     */
+    readonly timeoutMs?: number;
+    /**
+     * Interval between cleanup sweeps in milliseconds.
+     *
+     * The housekeeper checks for expired/stale sessions at this interval.
+     * Set to `0` to disable cleanup (e.g., stdio mode).
+     *
+     * @default 60_000 (60 seconds, from MCP_SESSION_CLEANUP_INTERVAL_MS)
+     */
+    readonly cleanupIntervalMs?: number;
+    /**
+     * Keep-alive heartbeat interval in milliseconds.
+     *
+     * The housekeeper sends keep-alive pings at this interval to detect
+     * dead connections. Set to `0` to disable heartbeats.
+     *
+     * @default 30_000 (30 seconds, from MCP_SESSION_KEEP_ALIVE_INTERVAL_MS)
+     */
+    readonly keepAliveIntervalMs?: number;
+    /**
+     * Maximum missed heartbeats before a session is considered stale.
+     *
+     * @default 3 (from MCP_SESSION_MAX_MISSED_HEARTBEATS)
+     */
+    readonly maxMissedHeartbeats?: number;
+    /**
+     * Maximum concurrent sessions across all transports.
+     *
+     * @default 200 (from MCP_MAX_SESSIONS)
+     */
+    readonly maxSessions?: number;
+    /**
+     * Custom session store implementation.
+     *
+     * When provided, replaces the built-in in-memory session store.
+     * Useful for horizontal scaling with Redis, PostgreSQL, or another
+     * shared backend.
+     *
+     * @default InMemorySessionStore
+     */
+    readonly store?: SessionStore;
+}
+/**
+ * Complete server configuration options.
+ *
+ * This interface provides a declarative way to configure an MCP server.
+ * All options have sensible defaults.
+ *
+ * @example
+ * ```typescript
+ * const options: ServerOptions = {
+ *   name: 'my-mcp-server',
+ *   version: '1.0.0',
+ *   transport: { mode: 'http', port: 8080 },
+ *   capabilities: { tools: true, resources: true },
+ *   lifecycle: {
+ *     onStarted: () => console.log('Server started!'),
+ *   },
+ * };
+ * ```
+ */
+export interface ServerOptions {
+    /**
+     * Server name displayed to MCP clients.
+     *
+     * @example 'my-mcp-server', 'api-mcp-server'
+     */
+    name: string;
+    /**
+     * Server version (typically from package.json).
+     *
+     * @example '1.0.0'
+     */
+    version: string;
+    /**
+     * Transport configuration (required).
+     *
+     * Explicitly specify how the server communicates with clients.
+     * Use `{ mode: 'stdio' }` for CLI usage or `{ mode: 'http' }` for network usage.
+     */
+    transport: TransportOptions;
+    /**
+     * Server capabilities to advertise.
+     *
+     * @default { tools: { listChanged: true }, logging: true }
+     */
+    capabilities?: ServerCapabilities | undefined;
+    /**
+     * Custom protocol handler hooks.
+     *
+     * Allows customizing behavior when MCP protocol events occur.
+     * The framework handles protocol compliance - these are for app logic.
+     *
+     * Note: Cancellation is handled automatically by the framework.
+     *
+     * @example
+     * ```typescript
+     * handlers: {
+     *   onPing: () => metrics.increment('mcp.ping'),
+     * }
+     * ```
+     */
+    handlers?: HandlersConfig | undefined;
+    /**
+     * Lifecycle hooks for startup/shutdown.
+     */
+    lifecycle?: ServerLifecycleHooks | undefined;
+    /**
+     * Shutdown configuration.
+     */
+    shutdown?: Partial<ShutdownConfig> | undefined;
+    /**
+     * Health endpoint configuration for API connectivity monitoring.
+     *
+     * Wires a {@link ConnectionStateManager} to the `/ready` endpoint so
+     * readiness probes reflect the actual API connection state.
+     */
+    health?: HealthConfig | undefined;
+    /**
+     * Session management configuration.
+     *
+     * Fine-tune session lifecycle behavior (timeouts, cleanup intervals,
+     * capacity). Only relevant for HTTP-based transports — stdio always
+     * uses a single session with no background tasks.
+     *
+     * All values are optional and fall back to environment variables / config
+     * file defaults from the standard config cascade.
+     *
+     * @see SessionConfigOptions for available options and defaults
+     */
+    session?: SessionConfigOptions | undefined;
+    /**
+     * Authentication configuration.
+     *
+     * Enables OAuth 2.1 or custom token verification on the server.
+     * When configured, the `/mcp` endpoint requires Bearer authentication.
+     * Health and metrics endpoints remain unauthenticated for probes.
+     *
+     * Only relevant for HTTP-based transports — stdio mode does not
+     * support authentication (a warning is logged if configured).
+     *
+     * @example OAuth provider
+     * ```typescript
+     * createServer({
+     *   name: 'my-server',
+     *   version: '1.0.0',
+     *   transport: { mode: 'http' },
+     *   auth: {
+     *     provider: myOAuthProvider,
+     *     issuerUrl: new URL('https://auth.example.com'),
+     *     requiredScopes: ['mcp:read'],
+     *   },
+     * });
+     * ```
+     *
+     * @example Custom token verifier
+     * ```typescript
+     * createServer({
+     *   name: 'my-server',
+     *   version: '1.0.0',
+     *   transport: { mode: 'http' },
+     *   auth: {
+     *     provider: { verifyAccessToken: async (token) => ({ ... }) },
+     *   },
+     * });
+     * ```
+     *
+     * @see AuthOptions for all configuration options
+     */
+    auth?: AuthOptions | undefined;
+    /**
+     * Enable OpenTelemetry tracing and metrics.
+     *
+     * When set via `createServer()`, this is resolved from:
+     * 1. Explicit `telemetry` option (highest priority)
+     * 2. `OTEL_ENABLED` env var or config file (fallback)
+     *
+     * @default undefined (resolved from config)
+     */
+    telemetryEnabled?: boolean | undefined;
+    /**
+     * OpenTelemetry service name.
+     *
+     * @default Server name
+     */
+    telemetryServiceName?: string | undefined;
+    /**
+     * Called before the OpenTelemetry SDK is initialized.
+     *
+     * Power users can use this callback to configure low-level OTEL APIs
+     * before the framework creates the NodeSDK instance. Common use cases:
+     *
+     * - Set a custom `DiagLogger` via `diag.setLogger()` for SDK-level
+     *   diagnostics (by default no DiagLogger is set — output is suppressed)
+     * - Register custom instrumentation
+     * - Configure global propagators or samplers
+     *
+     * The callback runs after framework config resolution but before
+     * `OTEL_LOG_LEVEL` is consumed from `process.env` and SDK construction.
+     * If you set a DiagLogger here, the framework will not override it.
+     *
+     * **Important**: Custom DiagLoggers must NOT write to stdout (reserved
+     * for MCP protocol data in stdio transport mode).
+     *
+     * @example
+     * ```typescript
+     * import { diag, DiagConsoleLogger, DiagLogLevel } from '@opentelemetry/api';
+     *
+     * const server = createServer({
+     *   name: 'my-server',
+     *   version: '1.0.0',
+     *   onBeforeTelemetryInit: () => {
+     *     diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);
+     *   },
+     * });
+     * ```
+     */
+    onBeforeTelemetryInit?: (() => void) | undefined;
+}
+/**
+ * Result from server builder/factory.
+ */
+export interface ServerInstance {
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server gracefully */
+    stop(): Promise<void>;
+    /**
+     * Initialize OpenTelemetry before starting the server.
+     *
+     * OTEL auto-instrumentation must be initialized before any HTTP/Express
+     * modules are loaded to properly instrument them. Call this method
+     * as early as possible in your application bootstrap.
+     *
+     * If not called explicitly, `start()` will initialize telemetry
+     * automatically as a fallback (but auto-instrumentation may miss
+     * modules already loaded).
+     *
+     * No-op if telemetry is not enabled in server options.
+     *
+     * @example
+     * ```typescript
+     * const server = builder.build();
+     * await server.initTelemetry(); // Before any other imports
+     * await server.start();
+     * ```
+     */
+    initTelemetry(): Promise<void>;
+    /**
+     * Notify all connected MCP clients that the tool list has changed.
+     *
+     * Call this when tool availability changes (e.g., connection state).
+     * The framework will send `notifications/tools/list_changed` to all
+     * connected clients per MCP specification.
+     *
+     * @example
+     * ```typescript
+     * // When API connection established
+     * apiClient.on('connected', () => server.notifyToolListChanged());
+     *
+     * // When API connection lost
+     * apiClient.on('disconnected', () => server.notifyToolListChanged());
+     * ```
+     */
+    notifyToolListChanged(): void;
+    /**
+     * Notify all connected MCP clients that the resource list has changed.
+     *
+     * Call this when resource availability changes dynamically.
+     * The framework will send `notifications/resources/list_changed` to all
+     * connected clients per MCP specification.
+     */
+    notifyResourceListChanged(): void;
+    /**
+     * Notify all connected MCP clients that the prompt list has changed.
+     *
+     * Call this when prompt availability changes dynamically.
+     * The framework will send `notifications/prompts/list_changed` to all
+     * connected clients per MCP specification.
+     */
+    notifyPromptListChanged(): void;
+    /**
+     * Notify subscribed MCP clients that a specific resource has been updated.
+     *
+     * Only clients that previously sent `resources/subscribe` for the given URI
+     * receive the `notifications/resources/updated` notification.
+     *
+     * Requires `capabilities: { resources: { subscribe: true } }` to be set.
+     *
+     * @param uri - The resource URI that has changed
+     *
+     * @example
+     * ```typescript
+     * // When a monitored resource changes
+     * server.notifyResourceUpdated('config://app/settings');
+     * ```
+     */
+    notifyResourceUpdated(uri: string): void;
+    /** Server name */
+    readonly name: string;
+    /** Server version */
+    readonly version: string;
+    /** Whether the server is running */
+    readonly isRunning: boolean;
+}
+//# sourceMappingURL=server-options.d.ts.map

package/build/server/server-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-options.d.ts","sourceRoot":"","sources":["../../src/server/server-options.ts"],"names":[],"mappings":"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"}

package/build/server/server-options.js

@@ -0,0 +1,17 @@
+/**
+ * Server Configuration Types
+ *
+ * Types for configuring and building MCP servers.
+ * Provides a clean, declarative API for server setup.
+ *
+ * @module server/server-options
+ */
+// ============================================================================
+// Transport Configuration (canonical location: transport-options.ts)
+// ============================================================================
+export { isHttpTransport, } from "./transport-options.js";
+// ============================================================================
+// Server Capabilities (canonical location: mcp/capabilities/server-capabilities.ts)
+// ============================================================================
+export { DEFAULT_CAPABILITIES } from "../mcp/capabilities/server-capabilities.js";
+//# sourceMappingURL=server-options.js.map

package/build/server/server-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-options.js","sourceRoot":"","sources":["../../src/server/server-options.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,+EAA+E;AAC/E,qEAAqE;AACrE,+EAA+E;AAE/E,OAAO,EAQL,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,+EAA+E;AAC/E,oFAAoF;AACpF,+EAA+E;AAE/E,OAAO,EAA2B,oBAAoB,EAAE,MAAM,4CAA4C,CAAC"}

package/build/server/session/in-memory-store.d.ts

@@ -0,0 +1,128 @@
+/**
+ * In-Memory Session Store
+ *
+ * Built-in session store implementation using a `Map`.
+ * Suitable for single-instance deployments.
+ *
+ * For horizontal scaling, implement the {@link SessionStore} interface
+ * with a shared backend (Redis, PostgreSQL, etc.).
+ *
+ * Contains NO timer logic — background tasks are handled by SessionHousekeeper.
+ *
+ * @module server/session/in-memory-store
+ */
+import type { TransportType } from "../transport/transport-context.js";
+import type { Session, ReadonlySession, SessionCloseReason, CreateSessionOptions } from "./session.js";
+import type { SessionStore, SessionStats } from "./session-store.js";
+/**
+ * Built-in in-memory session store using a `Map`.
+ *
+ * Suitable for single-instance deployments. For horizontal scaling,
+ * implement the {@link SessionStore} interface with a shared backend.
+ *
+ * Responsibilities:
+ * - Create, get, close, and query sessions
+ * - Enforce capacity limits
+ * - Track statistics (created, peak, by transport type)
+ * - Broadcast notifications to all connected clients
+ *
+ * Does NOT manage timers or background tasks.
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemorySessionStore(100);
+ *
+ * const session = store.create({ transportType: 'http', transport, mcpSession });
+ * const found = store.get(session.id);
+ * store.broadcastToolListChanged();
+ * await store.close(session.id, SESSION_CLOSE_REASONS.CLIENT_DISCONNECT);
+ * ```
+ */
+export declare class InMemorySessionStore implements SessionStore {
+    private readonly maxSessions;
+    /** Active sessions indexed by session ID */
+    private readonly sessions;
+    /** Statistics counters */
+    private readonly statsCounters;
+    /** Sessions by transport type (for stats) */
+    private readonly byTransportType;
+    /** Whether the store is rejecting new sessions */
+    private isShuttingDown;
+    constructor(maxSessions: number);
+    get size(): number;
+    get stats(): SessionStats;
+    /**
+     * Creates and registers a new session.
+     *
+     * Capacity check and insertion are synchronous (no await between them),
+     * which is safe in Node.js single-threaded event loop. Do NOT introduce
+     * any async operations between hasCapacity() and sessions.set().
+     *
+     * @param options - Session creation options
+     * @returns The created session, or undefined if at max capacity or shutting down
+     */
+    create(options: CreateSessionOptions): Session | undefined;
+    /**
+     * Gets an active session by ID.
+     * Does NOT update activity time (use touch() for that).
+     */
+    get(sessionId: string): Session | undefined;
+    /**
+     * Checks if a session exists and is active.
+     */
+    has(sessionId: string): boolean;
+    /**
+     * Updates the last activity time for a session.
+     * Also resets missed heartbeat count.
+     */
+    touch(sessionId: string): boolean;
+    /**
+     * Checks if there's capacity for new sessions.
+     */
+    hasCapacity(): boolean;
+    /**
+     * Removes a session from the store and updates statistics.
+     *
+     * Pure data operation — does NOT close transport or dispose MCP session.
+     * The caller (SessionManager) is responsible for I/O teardown.
+     *
+     * @param sessionId - Session identifier
+     * @param reason - Reason for closure (tracked in stats)
+     * @returns The removed session, or undefined if not found
+     */
+    remove(sessionId: string, reason: SessionCloseReason): Session | undefined;
+    /**
+     * Removes all sessions from the store during shutdown.
+     * Returns the removed sessions for the caller to handle I/O teardown.
+     */
+    removeAll(): Session[];
+    /**
+     * Marks the store as shutting down (rejects new sessions).
+     */
+    markShuttingDown(): void;
+    /**
+     * Iterates over all active sessions.
+     */
+    forEach(callback: (session: ReadonlySession, sessionId: string) => void): void;
+    /**
+     * Finds sessions matching a predicate.
+     */
+    filter(predicate: (session: ReadonlySession) => boolean): ReadonlySession[];
+    /**
+     * Gets all sessions of a specific transport type.
+     */
+    getByTransportType(type: TransportType): ReadonlySession[];
+    /**
+     * Broadcasts tool list changed notification to all active sessions.
+     */
+    broadcastToolListChanged(): void;
+    broadcastResourceListChanged(): void;
+    broadcastPromptListChanged(): void;
+    broadcastResourceUpdated(uri: string): void;
+    /**
+     * Broadcasts a notification to all active sessions.
+     * @internal
+     */
+    private broadcastToSessions;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

package/build/server/session/in-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../../src/server/session/in-memory-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEvG,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAyBrE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IAuB3C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAtBxC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD,0BAA0B;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;IAEF,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEF,kDAAkD;IAClD,OAAO,CAAC,cAAc,CAAS;gBAEF,WAAW,EAAE,MAAM;IAMhD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,YAAY,CAUxB;IAMD;;;;;;;;;OASG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,GAAG,SAAS;IA2B1D;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAK/B;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAajC;;OAEG;IACH,WAAW,IAAI,OAAO;IAQtB;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,GAAG,SAAS;IAsB1E;;;OAGG;IACH,SAAS,IAAI,OAAO,EAAE;IAkBtB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAQxB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAM9E;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,eAAe,EAAE;IAU3E;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,EAAE;IAQ1D;;OAEG;IACH,wBAAwB,IAAI,IAAI;IAIhC,4BAA4B,IAAI,IAAI;IAIpC,0BAA0B,IAAI,IAAI;IAIlC,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAgB3C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA0B5B"}