/** * Copyright (c) Microsoft Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import http from 'http'; import crypto from 'crypto'; import debug from 'debug'; import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'; import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js'; import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'; import { httpAddressToString, startHttpServer } from '../httpServer.js'; import * as mcpServer from './server.js'; import type { ServerBackendFactory } from './server.js'; export async function start(serverBackendFactory: ServerBackendFactory, options: { host?: string; port?: number }) { if (options.port !== undefined) { const httpServer = await startHttpServer(options); startHttpTransport(httpServer, serverBackendFactory); } else { await startStdioTransport(serverBackendFactory); } } async function startStdioTransport(serverBackendFactory: ServerBackendFactory) { await mcpServer.connect(serverBackendFactory, new StdioServerTransport()); } const testDebug = debug('pw:mcp:test'); async function handleSSE(serverBackendFactory: ServerBackendFactory, req: http.IncomingMessage, res: http.ServerResponse, url: URL, sessions: Map) { if (req.method === 'POST') { const sessionId = url.searchParams.get('sessionId'); if (!sessionId) { res.statusCode = 400; return res.end('Missing sessionId'); } const transport = sessions.get(sessionId); if (!transport) { res.statusCode = 404; return res.end('Session not found'); } return await transport.handlePostMessage(req, res); } else if (req.method === 'GET') { const transport = new SSEServerTransport('/sse', res); sessions.set(transport.sessionId, transport); testDebug(`create SSE session: ${transport.sessionId}`); await mcpServer.connect(serverBackendFactory, transport); res.on('close', () => { testDebug(`delete SSE session: ${transport.sessionId}`); sessions.delete(transport.sessionId); }); return; } res.statusCode = 405; res.end('Method not allowed'); } async function handleStreamable(serverBackendFactory: ServerBackendFactory, req: http.IncomingMessage, res: http.ServerResponse, sessions: Map) { const sessionId = req.headers['mcp-session-id'] as string | undefined; if (sessionId) { const transport = sessions.get(sessionId); if (!transport) { res.statusCode = 404; res.end('Session not found'); return; } return await transport.handleRequest(req, res); } if (req.method === 'POST') { const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: () => crypto.randomUUID(), onsessioninitialized: async sessionId => { testDebug(`create http session: ${transport.sessionId}`); await mcpServer.connect(serverBackendFactory, transport); sessions.set(sessionId, transport); } }); transport.onclose = () => { if (!transport.sessionId) return; sessions.delete(transport.sessionId); testDebug(`delete http session: ${transport.sessionId}`); }; await transport.handleRequest(req, res); return; } res.statusCode = 400; res.end('Invalid request'); } function startHttpTransport(httpServer: http.Server, serverBackendFactory: ServerBackendFactory) { const sseSessions = new Map(); const streamableSessions = new Map(); httpServer.on('request', async (req, res) => { const url = new URL(`http://localhost${req.url}`); if (url.pathname.startsWith('/mcp')) await handleStreamable(serverBackendFactory, req, res, streamableSessions); else await handleSSE(serverBackendFactory, req, res, url, sseSessions); }); const url = httpAddressToString(httpServer.address()); const message = [ `Listening on ${url}`, 'Put this in your client config:', JSON.stringify({ 'mcpServers': { 'playwright': { 'url': `${url}/mcp` } } }, undefined, 2), 'If your client supports streamable HTTP, you can use the /mcp endpoint instead.', ].join('\n'); // eslint-disable-next-line no-console console.error(message); }