import { IConfigurationOptions, IMidwayApplication, IMidwayContext, NextFunction as BaseNextFunction, } from '@midwayjs/core'; import { Implementation, CallToolResult, GetPromptResult, ReadResourceResult, } from '@modelcontextprotocol/sdk/types.js'; import { ServerOptions } from '@modelcontextprotocol/sdk/server/index.js'; import { SSEServerTransportOptions } from '@modelcontextprotocol/sdk/server/sse.js'; import { StreamableHTTPServerTransportOptions } from '@modelcontextprotocol/sdk/server/streamableHttp.js'; import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js'; import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js'; export interface IMidwayMCPConfigurationOptions extends IConfigurationOptions { serverInfo: Implementation; serverOptions?: ServerOptions; /** * Transport type for MCP communication * - 'stdio': Standard input/output transport for CLI applications * - 'stream-http': HTTP-based transport with streaming support and backward compatibility with SSE * - 'sse': Legacy SSE transport (deprecated, use 'stream-http' instead which provides backward compatibility) */ transportType: 'stdio' | 'sse' | 'stream-http'; /** * Endpoint paths for different transport types */ endpoints?: { /** StreamHTTP endpoint path (default: '/mcp') */ streamHttp?: string; /** SSE endpoint path for backward compatibility (default: '/sse') */ sse?: string; /** Messages endpoint path for backward compatibility (default: '/messages') */ messages?: string; }; /** * Transport-specific options using SDK types */ transportOptions?: { /** Options for SSE transport (from @modelcontextprotocol/sdk) */ sse?: SSEServerTransportOptions; /** Options for StreamHTTP transport (from @modelcontextprotocol/sdk) */ streamHttp?: StreamableHTTPServerTransportOptions; }; /** Enable built-in JWT authentication middleware (default: false) */ enableJwtAuthHelper?: boolean; /** Custom JWT payload transformer function */ jwtAuthCustomPayloadTransformer?: (payload: any, token: string) => AuthInfo; } export interface IMidwayMCPContext extends IMidwayContext, Partial> {} export type IMidwayMCPApplication = IMidwayApplication; export type Application = IMidwayMCPApplication; export interface Context extends IMidwayMCPContext {} export type NextFunction = BaseNextFunction; export interface IMcpResource { handle(...args: any[]): Promise; } export interface IMcpTool { execute(...args: any[]): Promise; } export interface IMcpPrompt { generate(...args: any[]): Promise; }