@get-technology-inc/jamf-docs-mcp-server 3.0.5 → 3.0.7

package/dist/platforms/node/http-server.js

@@ -0,0 +1,231 @@
+/**
+ * Node.js HTTP server adapter
+ *
+ * Bridges the platform-agnostic HTTP handler with Node.js `node:http`.
+ * All Node.js-specific code (IncomingMessage, ServerResponse, process,
+ * Buffer, env vars) is isolated here.
+ */
+import { createServer } from 'node:http';
+import { createHttpHandler } from '../../transport/http-handler.js';
+import { createStderrLogger } from '../../core/services/logging.js';
+import { createNodeConfig, getEnvNumber } from './config.js';
+import { DEFAULT_HTTP_CONFIG } from '../../transport/http-types.js';
+const log = createStderrLogger('http');
+// ============================================================================
+// Node.js request / response conversion
+// ============================================================================
+/**
+ * Convert Node.js IncomingMessage to a Web Standard Request.
+ *
+ * Injects the resolved client IP as an `X-Real-IP` header so the
+ * platform-agnostic handler can extract it without Node.js APIs.
+ */
+function toWebRequest(req, body, url, clientIp) {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value !== undefined) {
+            if (Array.isArray(value)) {
+                for (const v of value) {
+                    headers.append(key, v);
+                }
+            }
+            else {
+                headers.set(key, value);
+            }
+        }
+    }
+    // Inject resolved client IP for the platform-agnostic handler
+    headers.set('x-real-ip', clientIp);
+    const method = req.method ?? 'GET';
+    const init = {
+        method,
+        headers,
+    };
+    // Only add body for methods that support it
+    if (method !== 'GET' && method !== 'HEAD' && method !== 'DELETE') {
+        init.body = body;
+    }
+    return new Request(url.toString(), init);
+}
+/**
+ * Write a Web Standard Response back to Node.js ServerResponse.
+ */
+async function writeWebResponse(webRes, res) {
+    res.writeHead(webRes.status, Object.fromEntries(webRes.headers.entries()));
+    if (webRes.body === null) {
+        res.end();
+        return;
+    }
+    const reader = webRes.body.getReader();
+    try {
+        for (;;) {
+            const result = await reader.read();
+            if (result.done) {
+                break;
+            }
+            res.write(result.value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+        res.end();
+    }
+}
+/**
+ * Collect request body from IncomingMessage into a Buffer.
+ * Enforces a maximum body size to prevent memory exhaustion.
+ */
+async function collectBody(req, maxBodySize) {
+    const chunks = [];
+    let totalSize = 0;
+    for await (const chunk of req) {
+        const buf = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
+        totalSize += buf.length;
+        if (totalSize > maxBodySize) {
+            throw new Error('Payload too large');
+        }
+        chunks.push(buf);
+    }
+    return Buffer.concat(chunks);
+}
+// ============================================================================
+// Client IP extraction (Node.js-specific)
+// ============================================================================
+/**
+ * Get client IP from Node.js IncomingMessage.
+ * Only trusts X-Forwarded-For when TRUST_PROXY is enabled.
+ */
+function getNodeClientIp(req, trustProxy) {
+    if (trustProxy) {
+        const forwarded = req.headers['x-forwarded-for'];
+        if (typeof forwarded === 'string') {
+            const ips = forwarded.split(',').map(s => s.trim()).filter(Boolean);
+            return ips[ips.length - 1] ?? 'unknown';
+        }
+    }
+    // socket may be undefined in test environments
+    const socket = req.socket;
+    return socket?.remoteAddress ?? 'unknown';
+}
+// ============================================================================
+// Configuration from environment
+// ============================================================================
+function buildConfig() {
+    const nodeConfig = createNodeConfig();
+    const corsAllowedOrigins = (process.env.CORS_ALLOWED_ORIGINS ?? '')
+        .split(',')
+        .map(s => s.trim())
+        .filter(Boolean);
+    const trustProxy = process.env.TRUST_PROXY === 'true' || process.env.TRUST_PROXY === '1';
+    const rateLimitRpm = getEnvNumber('RATE_LIMIT_RPM', 60, 1, 10000);
+    return {
+        ...DEFAULT_HTTP_CONFIG,
+        serverVersion: nodeConfig.version,
+        corsAllowedOrigins,
+        trustProxy,
+        rateLimitRpm,
+    };
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Create and start an HTTP server for the MCP server (Node.js platform).
+ */
+export async function startHttpServer(mcpServer, port, host) {
+    const config = buildConfig();
+    // Platform-specific IP extractor: reads from X-Real-IP header
+    // that we inject in toWebRequest
+    const getClientIp = (request) => {
+        return request.headers.get('x-real-ip') ?? 'unknown';
+    };
+    const { handler, cleanup } = createHttpHandler(mcpServer, config, getClientIp, log);
+    const httpServer = createServer((req, res) => {
+        void handleNodeRequest(req, res, handler, config);
+    });
+    // Graceful shutdown
+    let shuttingDown = false;
+    function shutdown(signal) {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        log.info(`${signal} received, shutting down...`);
+        cleanup();
+        httpServer.close(() => {
+            log.info('HTTP server closed');
+            process.exit(0);
+        });
+        // Force exit after timeout
+        setTimeout(() => {
+            log.warning('Shutdown timeout, forcing exit');
+            process.exit(1);
+        }, config.shutdownTimeoutMs);
+    }
+    process.on('SIGINT', () => { shutdown('SIGINT'); });
+    process.on('SIGTERM', () => { shutdown('SIGTERM'); });
+    // Start listening
+    await new Promise((resolve, reject) => {
+        httpServer.on('error', (error) => {
+            if (error.code === 'EADDRINUSE') {
+                log.error(`Port ${port} is already in use`);
+                process.exit(1);
+            }
+            reject(error);
+        });
+        httpServer.listen(port, host, () => {
+            if (host !== '127.0.0.1' && host !== '::1') {
+                log.warning(`Server is binding to ${host}, which exposes it to the network. `
+                    + 'Use 127.0.0.1 for local-only access.');
+            }
+            log.info(`Jamf Docs MCP Server running on http://${host}:${port}`);
+            log.info(`MCP endpoint: http://${host}:${port}/mcp`);
+            log.info(`Health check: http://${host}:${port}/health`);
+            log.info(`LLMs info:   http://${host}:${port}/llms.txt`);
+            resolve();
+        });
+    });
+}
+// ============================================================================
+// Node.js request handler bridge
+// ============================================================================
+/**
+ * Bridge a single Node.js HTTP request into the platform-agnostic handler.
+ */
+async function handleNodeRequest(req, res, handler, config) {
+    const url = new URL(req.url ?? '/', 'http://localhost');
+    // Resolve client IP at the Node.js layer
+    const clientIp = getNodeClientIp(req, config.trustProxy);
+    // For methods that carry a body, collect it; otherwise use empty Buffer
+    const method = req.method ?? 'GET';
+    let body;
+    if (method !== 'GET' && method !== 'HEAD' && method !== 'DELETE' && method !== 'OPTIONS') {
+        try {
+            body = await collectBody(req, config.maxBodySize);
+        }
+        catch {
+            // Body too large — send 413, then destroy to stop reading remaining data
+            res.writeHead(413, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Payload too large' }), () => {
+                req.destroy();
+            });
+            return;
+        }
+    }
+    else {
+        body = Buffer.alloc(0);
+    }
+    // Convert to Web Standard Request
+    const webReq = toWebRequest(req, body, url, clientIp);
+    try {
+        const webRes = await handler(webReq);
+        await writeWebResponse(webRes, res);
+    }
+    catch {
+        if (!res.headersSent) {
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Internal server error' }));
+        }
+    }
+}
+//# sourceMappingURL=http-server.js.map

package/dist/platforms/node/http-server.js.map

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

package/dist/platforms/node/index.d.ts

@@ -3,6 +3,6 @@
  */
 export { FileCache } from './cache.js';
 export { NodeLoggerFactory } from './logger.js';
-export { NodeMetadataStore } from './metadata.js';
 export { createNodeConfig } from './config.js';
+export { startHttpServer } from './http-server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/platforms/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platforms/node/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platforms/node/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/platforms/node/index.js

@@ -3,6 +3,6 @@
  */
 export { FileCache } from './cache.js';
 export { NodeLoggerFactory } from './logger.js';
-export { NodeMetadataStore } from './metadata.js';
 export { createNodeConfig } from './config.js';
+export { startHttpServer } from './http-server.js';
 //# sourceMappingURL=index.js.map

package/dist/platforms/node/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platforms/node/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platforms/node/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/platforms/node/logger.d.ts

@@ -1,11 +1,22 @@
 /**
  * Node.js logger factory
  *
- * Wraps the existing logging implementation from core to implement LoggerFactory.
+ * Wraps a LoggingService instance to implement the LoggerFactory interface.
+ * Each NodeLoggerFactory holds its own LoggingService, avoiding
+ * module-level mutable state.
+ *
+ * Uses `console.error` (stderr) by default — the standard Node.js behaviour.
+ * A future WorkersLoggerFactory could pass `console.log` or a no-op instead.
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { Logger, LoggerFactory } from '../../core/services/interfaces/index.js';
+import type { Logger, LoggerFactory, WriteStderrFn } from '../../core/services/interfaces/index.js';
 export declare class NodeLoggerFactory implements LoggerFactory {
+    private readonly service;
+    /**
+     * @param writeStderr - Optional writer function. Defaults to `console.error`
+     *   (Node.js stderr). Override for testing or alternative output targets.
+     */
+    constructor(writeStderr?: WriteStderrFn);
     createLogger(name: string): Logger;
     setServer(server: McpServer): void;
 }

package/dist/platforms/node/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/platforms/node/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAMrF,qBAAa,iBAAkB,YAAW,aAAa;IACrD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAGnC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/platforms/node/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGpG,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC;;;OAGG;gBACS,WAAW,CAAC,EAAE,aAAa;IAIvC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAGnC"}

package/dist/platforms/node/logger.js

@@ -1,15 +1,28 @@
 /**
  * Node.js logger factory
  *
- * Wraps the existing logging implementation from core to implement LoggerFactory.
+ * Wraps a LoggingService instance to implement the LoggerFactory interface.
+ * Each NodeLoggerFactory holds its own LoggingService, avoiding
+ * module-level mutable state.
+ *
+ * Uses `console.error` (stderr) by default — the standard Node.js behaviour.
+ * A future WorkersLoggerFactory could pass `console.log` or a no-op instead.
  */
-import { createLogger as coreCreateLogger, setServer as coreSetServer, } from '../../core/services/logging.js';
+import { LoggingService } from '../../core/services/logging.js';
 export class NodeLoggerFactory {
+    service;
+    /**
+     * @param writeStderr - Optional writer function. Defaults to `console.error`
+     *   (Node.js stderr). Override for testing or alternative output targets.
+     */
+    constructor(writeStderr) {
+        this.service = new LoggingService(writeStderr);
+    }
     createLogger(name) {
-        return coreCreateLogger(name);
+        return this.service.createLogger(name);
     }
     setServer(server) {
-        coreSetServer(server);
+        this.service.setServer(server);
     }
 }
 //# sourceMappingURL=logger.js.map

package/dist/platforms/node/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/platforms/node/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,YAAY,IAAI,gBAAgB,EAChC,SAAS,IAAI,aAAa,GAC3B,MAAM,gCAAgC,CAAC;AAExC,MAAM,OAAO,iBAAiB;IAC5B,YAAY,CAAC,IAAY;QACvB,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,MAAiB;QACzB,aAAa,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/platforms/node/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAiB;IAEzC;;;OAGG;IACH,YAAY,WAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/transport/http-handler.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Platform-agnostic HTTP handler for the MCP server.
+ *
+ * Platform adapters (Node.js, Cloudflare Workers) convert their
+ * native request/response types to/from Web Standard objects and
+ * call the `handler` function returned by `createHttpHandler`.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type HttpHandlerConfig, type ClientIpExtractor, type Logger } from './http-types.js';
+/**
+ * Create a platform-agnostic HTTP handler for the MCP server.
+ *
+ * @param mcpServer    - The MCP server instance to connect per-request transports to
+ * @param config       - HTTP handler configuration
+ * @param getClientIp  - Platform-specific function to extract client IP from a Request
+ * @param logger       - Optional logger instance
+ * @returns An object with:
+ *   - `handler`: async function that takes a Web Standard Request and returns a Response
+ *   - `cleanup`: function to stop the rate limiter cleanup interval
+ */
+export declare function createHttpHandler(mcpServer: McpServer, config: HttpHandlerConfig, getClientIp: ClientIpExtractor, logger?: Logger): {
+    handler: (request: Request) => Promise<Response>;
+    cleanup: () => void;
+};
+//# sourceMappingURL=http-handler.d.ts.map

package/dist/transport/http-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-handler.d.ts","sourceRoot":"","sources":["../../src/transport/http-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,MAAM,EACZ,MAAM,iBAAiB,CAAC;AA6GzB;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,iBAAiB,EAC9B,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAuD3E"}

package/dist/transport/http-handler.js

@@ -0,0 +1,193 @@
+/**
+ * Platform-agnostic HTTP handler for the MCP server.
+ *
+ * Platform adapters (Node.js, Cloudflare Workers) convert their
+ * native request/response types to/from Web Standard objects and
+ * call the `handler` function returned by `createHttpHandler`.
+ */
+import { WebStandardStreamableHTTPServerTransport, } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+import { RateLimiter } from './rate-limiter.js';
+import { LLMS_TXT, PayloadTooLargeError, } from './http-types.js';
+// ============================================================================
+// Security headers
+// ============================================================================
+/** Security headers applied to all responses (defense-in-depth) */
+const SECURITY_HEADERS = {
+    'X-Content-Type-Options': 'nosniff',
+    'X-Frame-Options': 'DENY',
+    'Cache-Control': 'no-store',
+};
+// ============================================================================
+// CORS helper
+// ============================================================================
+function getCorsHeaders(origin, allowedOrigins) {
+    const headers = { ...SECURITY_HEADERS };
+    if (allowedOrigins.length === 0) {
+        // No origins configured -- deny cross-origin
+        return headers;
+    }
+    // If wildcard is in the list, allow all origins
+    if (allowedOrigins.includes('*')) {
+        headers['Access-Control-Allow-Origin'] = '*';
+        headers['Access-Control-Allow-Methods'] = 'GET, POST, OPTIONS';
+        headers['Access-Control-Allow-Headers'] = 'Content-Type';
+        return headers;
+    }
+    // Otherwise, check exact match against the allowed list
+    if (origin !== null && allowedOrigins.includes(origin)) {
+        headers['Access-Control-Allow-Origin'] = origin;
+        headers['Access-Control-Allow-Methods'] = 'GET, POST, OPTIONS';
+        headers['Access-Control-Allow-Headers'] = 'Content-Type';
+        headers['Access-Control-Max-Age'] = '86400';
+        headers.Vary = 'Origin';
+    }
+    return headers;
+}
+// ============================================================================
+// Body reading helper (Web Standard)
+// ============================================================================
+async function readBodyText(request, maxBodySize) {
+    // Fast reject via Content-Length header when available
+    const contentLength = request.headers.get('content-length');
+    if (contentLength !== null) {
+        const length = parseInt(contentLength, 10);
+        if (!isNaN(length) && length > maxBodySize) {
+            throw new PayloadTooLargeError();
+        }
+    }
+    const text = await request.text();
+    if (text.length > maxBodySize) {
+        throw new PayloadTooLargeError();
+    }
+    return text;
+}
+// ============================================================================
+// Response builder helpers
+// ============================================================================
+function jsonResponse(status, body, extraHeaders = {}) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: {
+            'Content-Type': 'application/json',
+            ...extraHeaders,
+        },
+    });
+}
+function textResponse(status, body, contentType, extraHeaders = {}) {
+    return new Response(body, {
+        status,
+        headers: {
+            'Content-Type': contentType,
+            ...extraHeaders,
+        },
+    });
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a platform-agnostic HTTP handler for the MCP server.
+ *
+ * @param mcpServer    - The MCP server instance to connect per-request transports to
+ * @param config       - HTTP handler configuration
+ * @param getClientIp  - Platform-specific function to extract client IP from a Request
+ * @param logger       - Optional logger instance
+ * @returns An object with:
+ *   - `handler`: async function that takes a Web Standard Request and returns a Response
+ *   - `cleanup`: function to stop the rate limiter cleanup interval
+ */
+export function createHttpHandler(mcpServer, config, getClientIp, logger) {
+    const rateLimiter = new RateLimiter(config.rateLimitRpm, 60_000);
+    const cleanupIntervalId = setInterval(() => { rateLimiter.cleanup(); }, 5 * 60_000);
+    // Prevent the interval from keeping the process alive (Node.js-specific,
+    // but calling .unref() is harmless on platforms that lack it).
+    if (typeof cleanupIntervalId === 'object' && 'unref' in cleanupIntervalId) {
+        cleanupIntervalId.unref();
+    }
+    function cleanup() {
+        clearInterval(cleanupIntervalId);
+    }
+    async function handler(request) {
+        // Use hardcoded base URL to prevent Host header injection
+        const url = new URL(request.url, 'http://localhost');
+        const { pathname } = url;
+        const origin = request.headers.get('origin');
+        const corsHeaders = getCorsHeaders(origin, config.corsAllowedOrigins);
+        // CORS preflight
+        if (request.method === 'OPTIONS') {
+            return new Response(null, {
+                status: 204,
+                headers: { ...corsHeaders, 'Content-Length': '0' },
+            });
+        }
+        // Rate limiting
+        const clientIp = getClientIp(request);
+        if (!rateLimiter.isAllowed(clientIp)) {
+            return jsonResponse(429, { error: 'Too many requests' }, corsHeaders);
+        }
+        // Health check
+        if (pathname === '/health' && request.method === 'GET') {
+            return jsonResponse(200, { status: 'ok', version: config.serverVersion }, corsHeaders);
+        }
+        // llms.txt
+        if (pathname === '/llms.txt' && request.method === 'GET') {
+            return textResponse(200, LLMS_TXT, 'text/plain; charset=utf-8', corsHeaders);
+        }
+        // MCP endpoint
+        if (pathname === '/mcp') {
+            return await handleMcp(request, mcpServer, config, corsHeaders, logger);
+        }
+        // 404 fallback
+        return jsonResponse(404, { error: 'Not found' }, corsHeaders);
+    }
+    return { handler, cleanup };
+}
+// ============================================================================
+// MCP endpoint handler
+// ============================================================================
+async function handleMcp(request, mcpServer, config, corsHeaders, logger) {
+    // Read body (with size enforcement)
+    let bodyText;
+    try {
+        bodyText = await readBodyText(request, config.maxBodySize);
+    }
+    catch (err) {
+        if (err instanceof PayloadTooLargeError) {
+            return jsonResponse(413, { error: 'Payload too large' }, corsHeaders);
+        }
+        throw err;
+    }
+    // Create a per-request transport (stateless mode)
+    const transport = new WebStandardStreamableHTTPServerTransport({
+        enableJsonResponse: config.enableJsonResponse,
+    });
+    // Connect the MCP server to this transport
+    await mcpServer.connect(transport);
+    try {
+        // Parse body if present
+        let parsedBody;
+        if (bodyText.length > 0) {
+            try {
+                parsedBody = JSON.parse(bodyText);
+            }
+            catch {
+                return jsonResponse(400, { error: 'Invalid JSON in request body' }, corsHeaders);
+            }
+        }
+        // Handle the request via the MCP transport
+        const webRes = await transport.handleRequest(request, { parsedBody });
+        // Add CORS + security headers to the response
+        for (const [key, value] of Object.entries(corsHeaders)) {
+            webRes.headers.set(key, value);
+        }
+        return webRes;
+    }
+    catch (err) {
+        logger?.error(`MCP handler error: ${err instanceof Error ? err.message : String(err)}`);
+        return jsonResponse(500, { error: 'Internal server error' }, corsHeaders);
+    }
+    finally {
+        await transport.close();
+    }
+}
+//# sourceMappingURL=http-handler.js.map

package/dist/transport/http-handler.js.map

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

package/dist/transport/http-types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared types and constants for the HTTP transport layer.
+ */
+import type { Logger } from '../core/services/interfaces/index.js';
+export type { Logger };
+export interface HttpHandlerConfig {
+    serverVersion: string;
+    corsAllowedOrigins: string[];
+    trustProxy: boolean;
+    rateLimitRpm: number;
+    maxBodySize: number;
+    enableJsonResponse: boolean;
+    shutdownTimeoutMs: number;
+}
+/** Platform-specific IP extraction -- Node reads socket, Workers reads CF header */
+export type ClientIpExtractor = (request: Request) => string;
+export declare const DEFAULT_HTTP_CONFIG: HttpHandlerConfig;
+export declare const LLMS_TXT = "# Jamf Docs MCP Server\n\n> MCP server providing access to official Jamf documentation from learn.jamf.com\n\n## Products\n- Jamf Pro \u2014 Apple device management for enterprise\n- Jamf School \u2014 Apple device management for education\n- Jamf Connect \u2014 identity and access management\n- Jamf Protect \u2014 endpoint security for Apple\n- Jamf Now \u2014 simple device management for small businesses\n- Jamf Safe Internet \u2014 content filtering and web security\n- Jamf Insights \u2014 analytics and reporting for Apple fleet\n- RapidIdentity \u2014 identity and access management platform\n\n## Tools\n- jamf_docs_list_products: discover available products and versions\n- jamf_docs_search: search documentation by keyword with product/topic filters\n- jamf_docs_get_article: retrieve full article content in markdown\n- jamf_docs_get_toc: browse table of contents for a product\n- jamf_docs_glossary_lookup: look up glossary terms with fuzzy matching\n- jamf_docs_batch_get_articles: retrieve multiple articles in a single request\n\n## Resources\n- jamf://products \u2014 product list with metadata and versions\n- jamf://topics \u2014 topic categories per product\n- jamf://products/{productId}/toc \u2014 table of contents for a specific product\n- jamf://products/{productId}/versions \u2014 available documentation versions\n\n## Prompts\n- jamf_troubleshoot: guided troubleshooting workflow\n- jamf_setup_guide: step-by-step setup instructions\n- jamf_compare_versions: compare features across versions\n\n## Supported Locales\nen-US, ja-JP, zh-TW, de-DE, es-ES, fr-FR, nl-NL, th-TH\n\n## Limitations\n- Documentation content only \u2014 no Jamf REST API reference\n- Content is sourced from learn.jamf.com and cached; not real-time\n";
+export declare class PayloadTooLargeError extends Error {
+    constructor();
+}
+//# sourceMappingURL=http-types.d.ts.map

package/dist/transport/http-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-types.d.ts","sourceRoot":"","sources":["../../src/transport/http-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAEnE,YAAY,EAAE,MAAM,EAAE,CAAC;AAMvB,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;AAE7D,eAAO,MAAM,mBAAmB,EAAE,iBAQjC,CAAC;AAMF,eAAO,MAAM,QAAQ,+tDAuCpB,CAAC;AAMF,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C"}