@j0hanz/fetch-url-mcp 1.12.7 → 1.12.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/fetch-url-mcp",
-  "version": "1.12.7",
+  "version": "1.12.8",
   "mcpName": "io.github.j0hanz/fetch-url-mcp",
   "description": "An MCP server that fetches web pages and converts them to clean, readable Markdown.",
   "type": "module",
@@ -94,7 +94,7 @@
     "eslint-plugin-de-morgan": "^2.1.1",
     "eslint-plugin-depend": "^1.5.0",
     "eslint-plugin-unused-imports": "^4.4.1",
-    "knip": "^6",
+    "knip": "^6.1.0",
     "prettier": "^3.8.1",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",

package/dist/cli.d.ts

@@ -1,19 +0,0 @@
-interface CliValues {
-    readonly stdio: boolean;
-    readonly http: boolean;
-    readonly help: boolean;
-    readonly version: boolean;
-}
-interface CliParseSuccess {
-    readonly ok: true;
-    readonly values: CliValues;
-}
-interface CliParseFailure {
-    readonly ok: false;
-    readonly message: string;
-}
-type CliParseResult = CliParseSuccess | CliParseFailure;
-export declare function renderCliUsage(): string;
-export declare function parseCliArgs(args: readonly string[]): CliParseResult;
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,UAAU,SAAS;IACjB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AA2CxD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CA2BpE"}

package/dist/cli.js

@@ -1,65 +0,0 @@
-import { parseArgs } from 'node:util';
-import { getErrorMessage } from './lib/utils.js';
-const usageLines = [
-    'Fetch URL MCP server',
-    '',
-    'Usage:',
-    '  fetch-url-mcp [--stdio|-s | --http] [--help|-h] [--version|-v]',
-    '',
-    'Options:',
-    '  --stdio, -s   Run in stdio mode (default).',
-    '  --http        Run in Streamable HTTP mode.',
-    '  --help, -h    Show this help message.',
-    '  --version, -v Show server version.',
-    '',
-];
-const optionSchema = {
-    stdio: { type: 'boolean', short: 's', default: false },
-    http: { type: 'boolean', default: false },
-    help: { type: 'boolean', short: 'h', default: false },
-    version: { type: 'boolean', short: 'v', default: false },
-};
-function toBoolean(value) {
-    return value === true;
-}
-function readCliFlag(values, key) {
-    return toBoolean(values[key]);
-}
-function buildCliValues(values) {
-    return {
-        stdio: readCliFlag(values, 'stdio'),
-        http: readCliFlag(values, 'http'),
-        help: readCliFlag(values, 'help'),
-        version: readCliFlag(values, 'version'),
-    };
-}
-export function renderCliUsage() {
-    return `${usageLines.join('\n')}\n`;
-}
-export function parseCliArgs(args) {
-    try {
-        const { values } = parseArgs({
-            args: [...args],
-            options: optionSchema,
-            strict: true,
-            allowPositionals: false,
-        });
-        const cliValues = buildCliValues(values);
-        if (cliValues.stdio && cliValues.http) {
-            return {
-                ok: false,
-                message: 'Choose either --stdio or --http, not both',
-            };
-        }
-        return {
-            ok: true,
-            values: cliValues,
-        };
-    }
-    catch (error) {
-        return {
-            ok: false,
-            message: getErrorMessage(error),
-        };
-    }
-}

package/dist/http/health.d.ts

@@ -1,8 +0,0 @@
-import type { SessionStore } from '../lib/core.js';
-import { type RequestContext } from './helpers.js';
-export declare function resetEventLoopMonitoring(): void;
-export declare function disableEventLoopMonitoring(): void;
-export declare function isVerboseHealthRequest(ctx: RequestContext): boolean;
-export declare function shouldHandleHealthRoute(ctx: RequestContext): boolean;
-export declare function sendHealthRouteResponse(store: SessionStore, ctx: RequestContext, authPresent: boolean): boolean;
-//# sourceMappingURL=health.d.ts.map

package/dist/http/health.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/http/health.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,KAAK,cAAc,EAAY,MAAM,cAAc,CAAC;AAY7D,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAqKD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAKnE;AAiCD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAEpE;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,OAAO,GACnB,OAAO,CAOT"}

package/dist/http/health.js

@@ -1,152 +0,0 @@
-import { freemem, hostname, totalmem } from 'node:os';
-import { monitorEventLoopDelay, performance } from 'node:perf_hooks';
-import process from 'node:process';
-import { config, serverVersion } from '../lib/core.js';
-import { getTransformPoolStats } from '../transform/transform.js';
-import { sendJson } from './helpers.js';
-// ---------------------------------------------------------------------------
-// Event-loop monitoring
-// ---------------------------------------------------------------------------
-const EVENT_LOOP_DELAY_RESOLUTION_MS = 20;
-const eventLoopDelay = monitorEventLoopDelay({
-    resolution: EVENT_LOOP_DELAY_RESOLUTION_MS,
-});
-let lastEventLoopUtilization = performance.eventLoopUtilization();
-export function resetEventLoopMonitoring() {
-    lastEventLoopUtilization = performance.eventLoopUtilization();
-    eventLoopDelay.reset();
-    eventLoopDelay.enable();
-}
-export function disableEventLoopMonitoring() {
-    eventLoopDelay.disable();
-}
-// ---------------------------------------------------------------------------
-// Stats helpers
-// ---------------------------------------------------------------------------
-function roundTo(value, precision) {
-    const factor = 10 ** precision;
-    return Math.round(value * factor) / factor;
-}
-function formatEventLoopUtilization(snapshot) {
-    return {
-        utilization: roundTo(snapshot.utilization, 4),
-        activeMs: Math.round(snapshot.active),
-        idleMs: Math.round(snapshot.idle),
-    };
-}
-function toMs(valueNs) {
-    return roundTo(valueNs / 1_000_000, 3);
-}
-function getEventLoopStats() {
-    const current = performance.eventLoopUtilization();
-    const delta = performance.eventLoopUtilization(current, lastEventLoopUtilization);
-    lastEventLoopUtilization = current;
-    return {
-        utilization: {
-            total: formatEventLoopUtilization(current),
-            sinceLast: formatEventLoopUtilization(delta),
-        },
-        delay: {
-            minMs: toMs(eventLoopDelay.min),
-            maxMs: toMs(eventLoopDelay.max),
-            meanMs: toMs(eventLoopDelay.mean),
-            stddevMs: toMs(eventLoopDelay.stddev),
-            p50Ms: toMs(eventLoopDelay.percentile(50)),
-            p95Ms: toMs(eventLoopDelay.percentile(95)),
-            p99Ms: toMs(eventLoopDelay.percentile(99)),
-        },
-    };
-}
-function buildHealthResponse(store, includeDiagnostics) {
-    const base = {
-        status: 'ok',
-        version: serverVersion,
-        uptime: Math.floor(process.uptime()),
-        timestamp: new Date().toISOString(),
-    };
-    if (!includeDiagnostics)
-        return base;
-    const poolStats = getTransformPoolStats();
-    return {
-        ...base,
-        os: {
-            hostname: hostname(),
-            platform: process.platform,
-            arch: process.arch,
-            memoryFree: freemem(),
-            memoryTotal: totalmem(),
-        },
-        process: {
-            pid: process.pid,
-            ppid: process.ppid,
-            memory: process.memoryUsage(),
-            cpu: process.cpuUsage(),
-            resource: process.resourceUsage(),
-            ...(typeof process.availableMemory === 'function'
-                ? { availableMemory: process.availableMemory() }
-                : {}),
-            ...(typeof process.constrainedMemory === 'function'
-                ? { constrainedMemory: process.constrainedMemory() }
-                : {}),
-        },
-        perf: getEventLoopStats(),
-        ...(typeof process.getActiveResourcesInfo === 'function'
-            ? { activeResources: process.getActiveResourcesInfo() }
-            : {}),
-        stats: {
-            activeSessions: store.size(),
-            workerPool: poolStats ?? {
-                queueDepth: 0,
-                activeWorkers: 0,
-                capacity: 0,
-            },
-        },
-    };
-}
-function sendHealth(store, res, includeDiagnostics) {
-    res.setHeader('Cache-Control', 'no-store');
-    sendJson(res, 200, buildHealthResponse(store, includeDiagnostics));
-}
-// ---------------------------------------------------------------------------
-// Health route helpers
-// ---------------------------------------------------------------------------
-export function isVerboseHealthRequest(ctx) {
-    const value = ctx.url.searchParams.get('verbose');
-    if (!value)
-        return false;
-    const normalized = value.trim().toLowerCase();
-    return normalized === '1' || normalized === 'true';
-}
-function isHealthRoute(ctx) {
-    return ctx.method === 'GET' && ctx.url.pathname === '/health';
-}
-function isVerboseHealthRoute(ctx) {
-    return isHealthRoute(ctx) && isVerboseHealthRequest(ctx);
-}
-function ensureHealthAuthIfNeeded(ctx, authPresent) {
-    if (!isVerboseHealthRoute(ctx))
-        return true;
-    if (!config.security.allowRemote)
-        return true;
-    if (authPresent)
-        return true;
-    sendJson(ctx.res, 401, {
-        error: 'Authentication required for verbose health metrics',
-    });
-    return false;
-}
-function resolveHealthDiagnosticsMode(ctx, authPresent) {
-    return (isVerboseHealthRoute(ctx) && (authPresent || !config.security.allowRemote));
-}
-export function shouldHandleHealthRoute(ctx) {
-    return isHealthRoute(ctx);
-}
-export function sendHealthRouteResponse(store, ctx, authPresent) {
-    if (!shouldHandleHealthRoute(ctx))
-        return false;
-    if (!ensureHealthAuthIfNeeded(ctx, authPresent))
-        return true;
-    const includeDiagnostics = resolveHealthDiagnosticsMode(ctx, authPresent);
-    sendHealth(store, ctx.res, includeDiagnostics);
-    return true;
-}

package/dist/http/helpers.d.ts

@@ -1,68 +0,0 @@
-import type { IncomingMessage, Server, ServerResponse } from 'node:http';
-import type { Server as HttpsServer } from 'node:https';
-import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
-import type { JsonRpcId } from '../lib/mcp-interop.js';
-export type NetworkServer = Server | HttpsServer;
-export interface RequestContext {
-    req: IncomingMessage;
-    res: ServerResponse;
-    url: URL;
-    method: string | undefined;
-    ip: string | null;
-    body: unknown;
-    signal?: AbortSignal;
-}
-export interface AuthenticatedContext extends RequestContext {
-    auth: AuthInfo;
-}
-export declare function sendJson(res: ServerResponse, status: number, body: unknown): void;
-export declare function sendEmpty(res: ServerResponse, status: number): void;
-export declare function sendError(res: ServerResponse, _code: number, message: string, status?: number, _id?: JsonRpcId | null): void;
-export declare function getHeaderValue(req: IncomingMessage, name: string): string | null;
-export declare function getMcpSessionId(req: IncomingMessage): string | null;
-export declare function findDuplicateSingleValueHeader(req: IncomingMessage): string | null;
-export declare function drainRequest(req: IncomingMessage): void;
-export declare function createRequestAbortSignal(req: IncomingMessage): {
-    signal: AbortSignal;
-    cleanup: () => void;
-};
-export declare function registerInboundBlockList(server: NetworkServer): void;
-export declare function buildRequestContext(req: IncomingMessage, res: ServerResponse, signal?: AbortSignal): RequestContext | null;
-export declare function closeTransportBestEffort(transport: {
-    close: () => Promise<unknown>;
-}, context: string): Promise<void>;
-export declare function closeMcpServerBestEffort(server: McpServer, context: string): Promise<void>;
-export declare function createTransportAdapter(transportImpl: StreamableHTTPServerTransport): Transport;
-type JsonBodyErrorKind = 'payload-too-large' | 'invalid-json' | 'read-failed';
-export declare class JsonBodyError extends Error {
-    readonly kind: JsonBodyErrorKind;
-    constructor(kind: JsonBodyErrorKind, message: string);
-}
-export declare function isJsonBodyError(error: unknown): error is JsonBodyError;
-export declare const DEFAULT_BODY_LIMIT_BYTES: number;
-declare class JsonBodyReader {
-    read(req: IncomingMessage, limit?: number, signal?: AbortSignal): Promise<unknown>;
-    private readBody;
-    private collectChunks;
-    private normalizeChunk;
-}
-export declare const jsonBodyReader: JsonBodyReader;
-interface SessionRecordLike {
-    server: McpServer;
-    transport: StreamableHTTPServerTransport;
-}
-interface SessionTeardownOptions {
-    cancelMessage: string;
-    closeServerReason?: string;
-    closeTransportReason?: string;
-    unregisterByServer?: boolean;
-    awaitClose?: boolean;
-}
-export declare function teardownSessionResources(session: SessionRecordLike, options: SessionTeardownOptions): Promise<void>;
-export declare function teardownUnregisteredSessionResources(session: SessionRecordLike, context: string): Promise<void>;
-export declare function teardownSessionRegistration(server: McpServer): void;
-export {};
-//# sourceMappingURL=helpers.d.ts.map

package/dist/http/helpers.d.ts.map

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