@nanogpt/mcp 1.0.0

package/dist/activeRequests.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Global registry for active HTTP requests
+ *
+ * Tracks AbortControllers for all in-flight HTTP requests to enable
+ * graceful shutdown - aborting pending requests when the server stops.
+ */
+/**
+ * Register an AbortController for tracking.
+ * Call this before starting an HTTP request.
+ */
+export declare function registerRequest(controller: AbortController): void;
+/**
+ * Unregister an AbortController after request completes.
+ * Call this in a finally block after the HTTP request.
+ */
+export declare function unregisterRequest(controller: AbortController): void;
+/**
+ * Abort all active requests and clear the registry.
+ * Call this during graceful shutdown.
+ */
+export declare function abortAllRequests(): void;
+/**
+ * Get the count of active requests (for debugging/logging).
+ */
+export declare function getActiveRequestCount(): number;
+//# sourceMappingURL=activeRequests.d.ts.map

package/dist/activeRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeRequests.d.ts","sourceRoot":"","sources":["../src/activeRequests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAEjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAEnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/activeRequests.js

@@ -0,0 +1,39 @@
+/**
+ * Global registry for active HTTP requests
+ *
+ * Tracks AbortControllers for all in-flight HTTP requests to enable
+ * graceful shutdown - aborting pending requests when the server stops.
+ */
+/** Set of active AbortControllers for in-flight HTTP requests */
+const activeRequests = new Set();
+/**
+ * Register an AbortController for tracking.
+ * Call this before starting an HTTP request.
+ */
+export function registerRequest(controller) {
+    activeRequests.add(controller);
+}
+/**
+ * Unregister an AbortController after request completes.
+ * Call this in a finally block after the HTTP request.
+ */
+export function unregisterRequest(controller) {
+    activeRequests.delete(controller);
+}
+/**
+ * Abort all active requests and clear the registry.
+ * Call this during graceful shutdown.
+ */
+export function abortAllRequests() {
+    for (const controller of activeRequests) {
+        controller.abort();
+    }
+    activeRequests.clear();
+}
+/**
+ * Get the count of active requests (for debugging/logging).
+ */
+export function getActiveRequestCount() {
+    return activeRequests.size;
+}
+//# sourceMappingURL=activeRequests.js.map

package/dist/activeRequests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeRequests.js","sourceRoot":"","sources":["../src/activeRequests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iEAAiE;AACjE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAA2B;IACzD,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA2B;IAC3D,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,CAAC;QACxC,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,cAAc,CAAC,IAAI,CAAC;AAC7B,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Configuration management for NanoGPT MCP server
+ *
+ * All configuration is read from environment variables.
+ * API keys are never logged or exposed.
+ */
+export type AuthMode = 'bearer' | 'x-api-key' | 'both';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Config {
+    baseUrl: string;
+    apiKey: string;
+    authMode: AuthMode;
+    timeoutMs: number;
+    maxRetries: number;
+    defaultModel?: string;
+    logLevel: LogLevel;
+    maxInlineJsonChars: number;
+    maxResourceCacheItems: number;
+    maxResourceBytes: number;
+    scrapeMaxUrls: number;
+}
+/**
+ * Validate and load configuration from environment variables.
+ * Fails fast with clear error messages (never prints API key).
+ */
+export declare function loadConfig(): Config;
+/**
+ * Get the current configuration. Throws if not loaded.
+ */
+export declare function getConfig(): Config;
+/**
+ * Safe logging that never exposes API keys
+ */
+export declare function log(level: LogLevel, message: string, data?: Record<string, unknown>): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAyEnC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAWD;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAsB1F"}

package/dist/config.js

@@ -0,0 +1,136 @@
+/**
+ * Configuration management for NanoGPT MCP server
+ *
+ * All configuration is read from environment variables.
+ * API keys are never logged or exposed.
+ */
+let config = null;
+/**
+ * Validate and load configuration from environment variables.
+ * Fails fast with clear error messages (never prints API key).
+ */
+export function loadConfig() {
+    const baseUrl = process.env.NANOGPT_BASE_URL;
+    const apiKey = process.env.NANOGPT_API_KEY;
+    // Required variables
+    const missing = [];
+    if (!baseUrl)
+        missing.push('NANOGPT_BASE_URL');
+    if (!apiKey)
+        missing.push('NANOGPT_API_KEY');
+    if (missing.length > 0) {
+        throw new Error(`Missing required environment variables: ${missing.join(', ')}`);
+    }
+    // Validate auth mode
+    const authModeRaw = process.env.NANOGPT_AUTH_MODE || 'bearer';
+    if (!['bearer', 'x-api-key', 'both'].includes(authModeRaw)) {
+        throw new Error(`Invalid NANOGPT_AUTH_MODE: ${authModeRaw}. Must be: bearer, x-api-key, or both`);
+    }
+    const authMode = authModeRaw;
+    // Validate log level
+    const logLevelRaw = process.env.NANOGPT_LOG_LEVEL || 'info';
+    if (!['debug', 'info', 'warn', 'error'].includes(logLevelRaw)) {
+        throw new Error(`Invalid NANOGPT_LOG_LEVEL: ${logLevelRaw}. Must be: debug, info, warn, or error`);
+    }
+    const logLevel = logLevelRaw;
+    // Parse numeric values with defaults
+    const timeoutMs = parseIntWithDefault(process.env.NANOGPT_TIMEOUT_MS, 120000);
+    if (timeoutMs <= 0) {
+        throw new Error(`NANOGPT_TIMEOUT_MS must be positive, got: ${timeoutMs}`);
+    }
+    const maxRetries = parseIntWithDefault(process.env.NANOGPT_MAX_RETRIES, 0);
+    if (maxRetries < 0) {
+        throw new Error(`NANOGPT_MAX_RETRIES must be non-negative, got: ${maxRetries}`);
+    }
+    const maxInlineJsonChars = parseIntWithDefault(process.env.NANOGPT_MAX_INLINE_JSON_CHARS, 10000);
+    if (maxInlineJsonChars <= 0) {
+        throw new Error(`NANOGPT_MAX_INLINE_JSON_CHARS must be positive, got: ${maxInlineJsonChars}`);
+    }
+    const maxResourceCacheItems = parseIntWithDefault(process.env.NANOGPT_MAX_RESOURCE_CACHE_ITEMS, 100);
+    if (maxResourceCacheItems <= 0) {
+        throw new Error(`NANOGPT_MAX_RESOURCE_CACHE_ITEMS must be positive, got: ${maxResourceCacheItems}`);
+    }
+    const maxResourceBytes = parseIntWithDefault(process.env.NANOGPT_MAX_RESOURCE_BYTES, 10485760);
+    if (maxResourceBytes <= 0) {
+        throw new Error(`NANOGPT_MAX_RESOURCE_BYTES must be positive, got: ${maxResourceBytes}`);
+    }
+    const scrapeMaxUrls = parseIntWithDefault(process.env.NANOGPT_SCRAPE_MAX_URLS, 5);
+    if (scrapeMaxUrls <= 0) {
+        throw new Error(`NANOGPT_SCRAPE_MAX_URLS must be positive, got: ${scrapeMaxUrls}`);
+    }
+    config = {
+        baseUrl: baseUrl.replace(/\/$/, ''), // Remove trailing slash
+        apiKey: apiKey,
+        authMode,
+        timeoutMs,
+        maxRetries,
+        defaultModel: process.env.NANOGPT_DEFAULT_MODEL,
+        logLevel,
+        maxInlineJsonChars,
+        maxResourceCacheItems,
+        maxResourceBytes,
+        scrapeMaxUrls,
+    };
+    return config;
+}
+/**
+ * Get the current configuration. Throws if not loaded.
+ */
+export function getConfig() {
+    if (!config) {
+        throw new Error('Configuration not loaded. Call loadConfig() first.');
+    }
+    return config;
+}
+/**
+ * Parse an integer with a default value
+ */
+function parseIntWithDefault(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * Safe logging that never exposes API keys
+ */
+export function log(level, message, data) {
+    const cfg = config || { logLevel: 'info' };
+    const levels = ['debug', 'info', 'warn', 'error'];
+    const currentLevel = levels.indexOf(cfg.logLevel);
+    const msgLevel = levels.indexOf(level);
+    // Skip if message level is below configured level
+    if (msgLevel < currentLevel) {
+        return;
+    }
+    // Sanitize data to remove any potential API key leaks
+    const sanitized = data ? sanitizeForLogging(data) : undefined;
+    const timestamp = new Date().toISOString();
+    const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+    if (sanitized) {
+        console.error(`${prefix} ${message}`, JSON.stringify(sanitized));
+    }
+    else {
+        console.error(`${prefix} ${message}`);
+    }
+}
+/**
+ * Remove sensitive data from objects before logging
+ */
+function sanitizeForLogging(data) {
+    const sensitive = ['apiKey', 'api_key', 'authorization', 'x-api-key', 'password', 'secret', 'token'];
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (sensitive.some((s) => key.toLowerCase().includes(s.toLowerCase()))) {
+            result[key] = '[REDACTED]';
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            result[key] = sanitizeForLogging(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/httpClient.d.ts

@@ -0,0 +1,36 @@
+/**
+ * HTTP client for NanoGPT API requests
+ *
+ * Handles authentication, timeouts, and error normalization.
+ * Never logs or exposes API keys.
+ */
+export interface HttpError {
+    status: number;
+    message: string;
+    code?: string;
+}
+export interface HttpResponse<T = unknown> {
+    status: number;
+    headers: Record<string, string>;
+    json: T;
+}
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    path: string;
+    body?: unknown;
+    query?: Record<string, string>;
+    timeoutMs?: number;
+}
+/**
+ * Make an HTTP request to NanoGPT
+ */
+export declare function requestJson<T = unknown>({ method, path, body, query, timeoutMs, }: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Type guard for HttpError
+ */
+export declare function isHttpError(err: unknown): err is HttpError;
+/**
+ * Format error for user display (never includes secrets)
+ */
+export declare function formatErrorMessage(err: HttpError): string;
+//# sourceMappingURL=httpClient.d.ts.map

package/dist/httpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.d.ts","sourceRoot":"","sources":["../src/httpClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgDD;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,EAC7C,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,SAAS,GACV,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAqH3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CAS1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CA6BzD"}

package/dist/httpClient.js

@@ -0,0 +1,211 @@
+/**
+ * HTTP client for NanoGPT API requests
+ *
+ * Handles authentication, timeouts, and error normalization.
+ * Never logs or exposes API keys.
+ */
+import { getConfig } from './config.js';
+import { registerRequest, unregisterRequest } from './activeRequests.js';
+// Safe headers to expose in raw responses
+const SAFE_RESPONSE_HEADERS = [
+    'x-request-id',
+    'x-vercel-id',
+    'x-payment-response', // Exposed for payment flow observability per spec
+    'content-type',
+    'content-length',
+];
+/**
+ * Extract a safe subset of headers for debugging
+ */
+function extractSafeHeaders(headers) {
+    const safe = {};
+    for (const key of SAFE_RESPONSE_HEADERS) {
+        const value = headers.get(key);
+        if (value) {
+            safe[key] = value;
+        }
+    }
+    return safe;
+}
+/**
+ * Extract error message from upstream response.
+ * Handles JSON error objects and plain text responses wrapped as { text }.
+ */
+function extractErrorMessage(json) {
+    if (typeof json === 'object' && json !== null) {
+        const obj = json;
+        if (typeof obj.error === 'string') {
+            return obj.error;
+        }
+        if (typeof obj.error === 'object' && obj.error !== null) {
+            const errorObj = obj.error;
+            if (typeof errorObj.message === 'string') {
+                return errorObj.message;
+            }
+        }
+        if (typeof obj.message === 'string') {
+            return obj.message;
+        }
+        // Handle non-JSON responses wrapped as { text } (e.g., HTML error pages, plain text)
+        if (typeof obj.text === 'string') {
+            // Truncate long HTML/text responses to a reasonable length
+            const text = obj.text.trim();
+            if (text.length > 200) {
+                return text.slice(0, 200) + '...';
+            }
+            return text || 'Unknown error';
+        }
+    }
+    return 'Unknown error';
+}
+/**
+ * Make an HTTP request to NanoGPT
+ */
+export async function requestJson({ method, path, body, query, timeoutMs, }) {
+    const config = getConfig();
+    const timeout = timeoutMs ?? config.timeoutMs;
+    // Build URL
+    const url = new URL(path, config.baseUrl);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            url.searchParams.set(key, value);
+        }
+    }
+    // Build headers
+    const headers = {
+        'Content-Type': 'application/json',
+        'User-Agent': `nanogpt-mcp/1.0.0`,
+    };
+    // Add auth headers based on mode
+    const authMode = config.authMode;
+    if (authMode === 'bearer' || authMode === 'both') {
+        headers['Authorization'] = `Bearer ${config.apiKey}`;
+    }
+    if (authMode === 'x-api-key' || authMode === 'both') {
+        headers['x-api-key'] = config.apiKey;
+    }
+    // Setup abort controller for timeout and graceful shutdown
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    // Register controller for graceful shutdown support
+    registerRequest(controller);
+    try {
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        // Extract safe headers
+        const safeHeaders = extractSafeHeaders(response.headers);
+        // Parse JSON response
+        let json;
+        const contentType = response.headers.get('content-type') || '';
+        if (contentType.includes('application/json')) {
+            try {
+                json = await response.json();
+            }
+            catch {
+                json = null;
+            }
+        }
+        else {
+            const text = await response.text();
+            json = { text };
+        }
+        // Handle non-2xx responses
+        if (!response.ok) {
+            const errorMessage = extractErrorMessage(json);
+            const error = {
+                status: response.status,
+                message: errorMessage,
+            };
+            // Extract error code if present
+            if (typeof json === 'object' && json !== null) {
+                const obj = json;
+                if (typeof obj.code === 'string') {
+                    error.code = obj.code;
+                }
+            }
+            throw error;
+        }
+        return {
+            status: response.status,
+            headers: safeHeaders,
+            json: json,
+        };
+    }
+    catch (err) {
+        clearTimeout(timeoutId);
+        // Handle abort/timeout
+        if (err instanceof Error && err.name === 'AbortError') {
+            throw {
+                status: 408,
+                message: 'Request timed out',
+            };
+        }
+        // Re-throw HttpError
+        if (isHttpError(err)) {
+            throw err;
+        }
+        // Handle network errors
+        if (err instanceof Error) {
+            throw {
+                status: 0,
+                message: `Network error: ${err.message}`,
+            };
+        }
+        throw {
+            status: 0,
+            message: 'Unknown error occurred',
+        };
+    }
+    finally {
+        // Always unregister the controller when request completes
+        unregisterRequest(controller);
+    }
+}
+/**
+ * Type guard for HttpError
+ */
+export function isHttpError(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'status' in err &&
+        'message' in err &&
+        typeof err.status === 'number' &&
+        typeof err.message === 'string');
+}
+/**
+ * Format error for user display (never includes secrets)
+ */
+export function formatErrorMessage(err) {
+    const { status, message, code } = err;
+    if (status === 401) {
+        return 'Authentication failed. Check your NANOGPT_API_KEY.';
+    }
+    if (status === 402) {
+        return `Insufficient balance: ${message}. Please top up your NanoGPT account.`;
+    }
+    if (status === 403) {
+        if (code === 'paid_features_disabled') {
+            return 'Paid features are disabled. Enable paid models in your NanoGPT settings.';
+        }
+        return `Access denied: ${message}`;
+    }
+    if (status === 408 || status === 499 || status === 504) {
+        return `Request timed out or was aborted: ${message}`;
+    }
+    if (status === 429) {
+        return `Rate limited: ${message}. Please wait and try again.`;
+    }
+    if (status >= 500) {
+        return `Server error (${status}): ${message}. Please try again later.`;
+    }
+    if (status === 400) {
+        return `Invalid request: ${message}`;
+    }
+    return `Error (${status}): ${message}`;
+}
+//# sourceMappingURL=httpClient.js.map

package/dist/httpClient.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * NanoGPT MCP Server
+ *
+ * An MCP server that provides access to NanoGPT's API capabilities:
+ * - Chat completion
+ * - Image generation
+ * - Web search
+ * - URL scraping
+ * - YouTube transcription
+ * - Model listing
+ *
+ * Uses stdio transport for communication with MCP clients.
+ *
+ * Pinned MCP SDK version: @modelcontextprotocol/sdk@^1.23.0
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}