/** * Stateless Streamable HTTP transport for an MCP server: one JSON-RPC message * per POST, answered with a JSON body. Uses standard Request and Response so * any web-standard runtime can mount it. The host owns routing and any access * control in front of it. */ import { MCP_PROTOCOL_VERSIONS, parseErrorResponse } from './protocol.js'; const MAX_BODY_BYTES = 1024 * 1024; /** Return `(request) => Promise` for an MCP server. */ export function createMcpHttpHandler(server) { return async function handleMcpRequest(request) { if (request.method !== 'POST') return new Response(null, { status: 405, headers: { Allow: 'POST' } }); const version = request.headers.get('mcp-protocol-version'); if (version && !MCP_PROTOCOL_VERSIONS.includes(version)) return json(400, { error: `Unsupported MCP protocol version: ${version}`, }); const type = request.headers.get('content-type') || ''; if (!/^application\/json\b/i.test(type)) return json(415, { error: 'Content-Type must be application/json' }); const declared = Number(request.headers.get('content-length')); if (declared > MAX_BODY_BYTES) return json(413, { error: 'Request too large' }); const text = await readCapped(request, MAX_BODY_BYTES); if (text === null) return json(413, { error: 'Request too large' }); let message; try { message = JSON.parse(text); } catch { return json(400, parseErrorResponse()); } const response = await server.handle(message, { signal: request.signal }); return response ? json(200, response) : new Response(null, { status: 202 }); }; } /** * Read a request body as text, stopping as soon as it passes `limit` bytes, * so a body without a Content-Length cannot be buffered without bound. * Returns null when the body is too large. */ async function readCapped(request, limit) { if (!request.body) return ''; const reader = request.body.getReader(); const chunks = []; let size = 0; for (;;) { const { done, value } = await reader.read(); if (done) break; size += value.byteLength; if (size > limit) { await reader.cancel().catch(() => {}); return null; } chunks.push(value); } const bytes = new Uint8Array(size); let offset = 0; for (const chunk of chunks) { bytes.set(chunk, offset); offset += chunk.byteLength; } return new TextDecoder().decode(bytes); } function json(status, body) { return new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-store', }, }); }