@zebpay_rajesh/zebpay-mcp-server 1.0.3

package/dist/mcp/errors.js

@@ -0,0 +1,214 @@
+/*
+  MCP error handling utilities using MCP SDK error types.
+*/
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Creates an MCP error for invalid parameters with helpful messages
+ */
+export function createInvalidParamsError(message, data) {
+    return new McpError(ErrorCode.InvalidParams, message, data);
+}
+/**
+ * Creates an MCP error for internal/server errors
+ */
+export function createInternalError(message, data) {
+    return new McpError(ErrorCode.InternalError, message, data);
+}
+/**
+ * Converts HTTP errors to appropriate MCP errors.
+ *
+ * NOTE: This is transport-agnostic - converts errors from Zebpay API (external)
+ * to MCP-compliant errors. Works identically for both stdio and HTTP transports.
+ *
+ * @param status HTTP status code from Zebpay API
+ * @param message Error message (may be HTML if from Cloudflare)
+ * @param details Additional error details
+ * @param isHtmlResponse Whether the response was HTML (for Cloudflare errors)
+ */
+export function convertHttpErrorToMcpError(status, message, details, isHtmlResponse) {
+    // If message is HTML or contains HTML tags, try to extract meaningful error
+    if (isHtmlResponse || (typeof message === "string" && (message.includes("<!doctype") || message.includes("<html")))) {
+        // Try to parse HTML error
+        const htmlText = typeof message === "string" ? message : String(details || "");
+        const parsedMessage = parseHtmlError(htmlText);
+        if (parsedMessage) {
+            message = parsedMessage;
+        }
+        else {
+            // Fallback for HTML errors
+            if (htmlText.includes("Access denied") || htmlText.includes("banned")) {
+                message = "Access denied: Your IP address has been restricted. Please contact support or try again later.";
+            }
+            else if (htmlText.includes("Cloudflare")) {
+                message = "Cloudflare error: Access to the API has been restricted. Please try again later or contact support.";
+            }
+            else {
+                message = "API access error: The server returned an HTML error page. Please check your API credentials and try again.";
+            }
+        }
+    }
+    // 4xx errors are typically invalid parameters or requests
+    if (status >= 400 && status < 500) {
+        // 401/403 are authentication errors - treat as invalid params
+        if (status === 401 || status === 403) {
+            const userMessage = message && message !== `HTTP ${status}` && !message.startsWith("HTTP")
+                ? `${message}. Please check your API credentials.`
+                : "Authentication failed. Please check your API credentials and try again.";
+            return createInvalidParamsError(userMessage, { status, details });
+        }
+        // 400 is bad request - invalid params
+        if (status === 400) {
+            // Extract additional error details from response
+            let enhancedMessage = message;
+            let statusCode;
+            let statusDescription;
+            if (details && typeof details === "object") {
+                const detailsObj = details;
+                statusCode = typeof detailsObj.statusCode === "number" ? detailsObj.statusCode : undefined;
+                statusDescription = typeof detailsObj.statusDescription === "string"
+                    ? detailsObj.statusDescription
+                    : undefined;
+                // Handle specific API error codes
+                if (statusCode === 77 && statusDescription) {
+                    // Market order minimum value error
+                    // Extract minimum value from the error message if present
+                    const minValueMatch = statusDescription.match(/minimum\s+([\d,]+\.?\d*)\s+(\w+)/i);
+                    if (minValueMatch) {
+                        const minValue = minValueMatch[1];
+                        const currency = minValueMatch[2];
+                        enhancedMessage = `${statusDescription} Please ensure your order value meets the minimum requirement of ${minValue} ${currency}.`;
+                    }
+                    else {
+                        enhancedMessage = statusDescription;
+                    }
+                }
+                else if (statusCode && statusDescription) {
+                    // Use the status description with code for context
+                    enhancedMessage = `[Error ${statusCode}] ${statusDescription}`;
+                }
+                else if (statusDescription) {
+                    // Use the status description if available
+                    enhancedMessage = statusDescription;
+                }
+            }
+            // If message already contains useful information, use it directly
+            // Otherwise, provide a generic message
+            const userMessage = enhancedMessage && enhancedMessage !== "HTTP 400" && !enhancedMessage.startsWith("HTTP")
+                ? enhancedMessage
+                : message && message !== "HTTP 400" && !message.startsWith("HTTP")
+                    ? message
+                    : "The request was invalid. Please check your parameters and try again.";
+            return createInvalidParamsError(userMessage, { status, statusCode, statusDescription, details });
+        }
+        // 404 is not found - could be invalid symbol or resource
+        if (status === 404) {
+            const userMessage = message && message !== "HTTP 404" && !message.startsWith("HTTP")
+                ? `${message}. Please check the symbol or resource identifier.`
+                : "Resource not found. Please check the symbol or resource identifier and try again.";
+            return createInvalidParamsError(userMessage, { status, details });
+        }
+        // 429 is rate limit - treat as internal error with retry guidance
+        if (status === 429) {
+            const userMessage = message && message !== "HTTP 429" && !message.startsWith("HTTP")
+                ? `Rate limit exceeded: ${message}. Please retry after a short delay.`
+                : "Rate limit exceeded. Please wait a moment and try again.";
+            return createInternalError(userMessage, { status, details, retryable: true });
+        }
+        // Other 4xx errors
+        const userMessage = message && message !== `HTTP ${status}` && !message.startsWith("HTTP")
+            ? message
+            : `Request error (${status}). Please check your parameters and try again.`;
+        return createInvalidParamsError(userMessage, { status, details });
+    }
+    // 5xx errors are server/internal errors
+    if (status >= 500) {
+        const userMessage = message && message !== `HTTP ${status}` && !message.startsWith("HTTP")
+            ? `Zebpay API server error: ${message}. Please try again later.`
+            : `Zebpay API server error (${status}). The server encountered an issue. Please try again later.`;
+        return createInternalError(userMessage, { status, details, retryable: true });
+    }
+    // Network errors (status 0) or other errors
+    const userMessage = message && message !== "Network error" && message !== "Unknown API error"
+        ? `Network error: ${message}. Please check your connection and try again.`
+        : "Network error. Please check your internet connection and try again.";
+    return createInternalError(userMessage, { status, details, retryable: true });
+}
+/**
+ * Parses HTML error pages (like Cloudflare) to extract user-friendly error messages.
+ *
+ * NOTE: Transport-agnostic - parses HTML responses from Zebpay API (external),
+ * not from MCP clients. Works for both stdio and HTTP transports.
+ */
+function parseHtmlError(html) {
+    if (!html || typeof html !== "string") {
+        return null;
+    }
+    // Check if it's HTML
+    if (!html.trim().toLowerCase().startsWith("<!doctype") && !html.trim().toLowerCase().startsWith("<html")) {
+        return null;
+    }
+    // Extract Cloudflare error messages
+    const cloudflarePatterns = [
+        // Cloudflare Error 1006 - Access denied
+        /<h2[^>]*>Access denied<\/h2>/i,
+        /The owner of this website.*?has banned your IP address[^<]*/i,
+        /<p[^>]*>The owner of this website[^<]*<\/p>/i,
+        // Cloudflare Error 1020 - Access denied
+        /<h1[^>]*>Error[^<]*<\/h1>/i,
+        // Generic error extraction from title
+        /<title>([^<]+)<\/title>/i,
+        // Extract error messages from h1/h2 tags
+        /<h[12][^>]*>([^<]+)<\/h[12]>/i,
+    ];
+    for (const pattern of cloudflarePatterns) {
+        const match = html.match(pattern);
+        if (match) {
+            let message = match[1] || match[0];
+            // Clean up HTML entities and tags
+            message = message
+                .replace(/<[^>]+>/g, "")
+                .replace(/&nbsp;/g, " ")
+                .replace(/&amp;/g, "&")
+                .replace(/&lt;/g, "<")
+                .replace(/&gt;/g, ">")
+                .replace(/&quot;/g, '"')
+                .replace(/\s+/g, " ")
+                .trim();
+            if (message && message.length > 10) {
+                // Check for IP ban message
+                if (html.includes("banned your IP address")) {
+                    const ipMatch = html.match(/IP address[^<]*\(([^)]+)\)/i);
+                    if (ipMatch) {
+                        return `Access denied: Your IP address has been banned by the website. Please contact support or try again later.`;
+                    }
+                    return `Access denied: Your IP address has been restricted. Please contact support or try again later.`;
+                }
+                // Check for Cloudflare error codes
+                const errorCodeMatch = html.match(/Error\s*(\d+)/i);
+                if (errorCodeMatch) {
+                    const errorCode = errorCodeMatch[1];
+                    if (errorCode === "1006") {
+                        return `Access denied (Error 1006): Your IP address has been banned. Please contact support or try again later.`;
+                    }
+                    return `Cloudflare error (${errorCode}): ${message}`;
+                }
+                return message;
+            }
+        }
+    }
+    // Fallback: try to extract any meaningful text
+    const textMatch = html.match(/<body[^>]*>([\s\S]{100,500})<\/body>/i);
+    if (textMatch) {
+        let text = textMatch[1]
+            .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+            .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+            .replace(/<[^>]+>/g, " ")
+            .replace(/\s+/g, " ")
+            .trim();
+        if (text.length > 20 && text.length < 200) {
+            return text;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=errors.js.map

package/dist/mcp/errors.js.map

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

package/dist/mcp/logging.d.ts

@@ -0,0 +1,21 @@
+export interface LogContext {
+    toolName: string;
+    logLevel: "debug" | "info" | "warn" | "error";
+    correlationId?: string;
+}
+/**
+ * Logs MCP tool request with parameters
+ */
+export declare function logMcpRequest(context: LogContext, params: unknown): void;
+/**
+ * Logs MCP tool response (success)
+ */
+export declare function logMcpResponse(context: LogContext, params: unknown, result: unknown, durationMs: number): void;
+/**
+ * Logs MCP tool error response
+ */
+export declare function logMcpError(context: LogContext, params: unknown, error: unknown, durationMs: number): void;
+/**
+ * Wraps an MCP tool handler with request/response logging
+ */
+export declare function withLogging<TParams, TResult>(toolName: string, logLevel: "debug" | "info" | "warn" | "error", handler: (params: TParams) => Promise<TResult>): (params: TParams) => Promise<TResult>;

package/dist/mcp/logging.js

@@ -0,0 +1,241 @@
+/*
+  MCP request/response logging utility for tracing and debugging.
+*/
+import { fileLogger } from "../utils/fileLogger.js";
+import { generateCorrelationId } from "../utils/responseFormatter.js";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Logs MCP tool request with parameters
+ */
+export function logMcpRequest(context, params) {
+    try {
+        const { toolName, logLevel, correlationId } = context;
+        const timestamp = new Date().toISOString();
+        const logMessage = JSON.stringify({
+            level: "info",
+            type: "mcp_request",
+            timestamp,
+            tool: toolName,
+            correlationId: correlationId || generateCorrelationId(),
+            params: sanitizeParams(params),
+        });
+        fileLogger.log(logMessage);
+    }
+    catch (error) {
+        // Silently fail logging to prevent breaking the application
+        console.error(`[LOG ERROR] Failed to log MCP request: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Logs MCP tool response (success)
+ */
+export function logMcpResponse(context, params, result, durationMs) {
+    try {
+        const { toolName, logLevel, correlationId } = context;
+        const timestamp = new Date().toISOString();
+        const logMessage = JSON.stringify({
+            level: "info",
+            type: "mcp_response",
+            timestamp,
+            tool: toolName,
+            correlationId: correlationId || generateCorrelationId(),
+            params: sanitizeParams(params),
+            success: true,
+            durationMs,
+            result: sanitizeResult(result),
+        });
+        fileLogger.log(logMessage);
+    }
+    catch (error) {
+        // Silently fail logging to prevent breaking the application
+        console.error(`[LOG ERROR] Failed to log MCP response: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Sanitizes stack traces by removing file paths, keeping only function names and line numbers
+ */
+function sanitizeStack(stack) {
+    if (!stack)
+        return undefined;
+    try {
+        // Remove file:// URLs and absolute paths, keep only filename and line numbers
+        const lines = stack.split('\n');
+        const sanitizedLines = lines.map(line => {
+            let sanitized = line;
+            // Remove file:// URLs (e.g., file:///Users/path/to/file.js:123:45)
+            sanitized = sanitized.replace(/file:\/\/\/[^\s\)]+/g, (match) => {
+                // Extract just the filename and line numbers
+                const filenameMatch = match.match(/([^\/]+\.(js|ts|mjs|cjs)):(\d+):(\d+)/);
+                if (filenameMatch) {
+                    return `${filenameMatch[1]}:${filenameMatch[3]}:${filenameMatch[4]}`;
+                }
+                return '';
+            });
+            // Remove absolute paths (e.g., /Users/path/to/file.js:123:45)
+            sanitized = sanitized.replace(/\/(?:[^\/\s]+\/)+([^\/\s]+\.(js|ts|mjs|cjs)):(\d+):(\d+)/g, '$1:$3:$4');
+            // Simplify node_modules paths (e.g., node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js)
+            sanitized = sanitized.replace(/node_modules\/([^\/\s]+)\/[^\s\)]+/g, 'node_modules/$1');
+            return sanitized.trim();
+        });
+        return sanitizedLines.join('\n');
+    }
+    catch {
+        // If sanitization fails, return a minimal version without paths
+        return stack.split('\n').slice(0, 3).join('\n'); // Keep only first 3 lines
+    }
+}
+/**
+ * Logs MCP tool error response
+ */
+export function logMcpError(context, params, error, durationMs) {
+    try {
+        const { toolName, logLevel, correlationId } = context;
+        const timestamp = new Date().toISOString();
+        // Extract error details
+        let errorMessage = error instanceof Error ? error.message : String(error);
+        let errorStack = error instanceof Error ? error.stack : undefined;
+        let errorCode;
+        let errorData;
+        // If it's an MCP error, extract additional details
+        if (error instanceof McpError) {
+            errorCode = error.code;
+            errorData = error.data;
+            // MCP errors have a formatted message, use it directly
+            errorMessage = error.message;
+        }
+        else if (error && typeof error === "object" && "code" in error) {
+            // Check if it's an MCP error-like object (from SDK)
+            errorCode = typeof error.code === "number" ? error.code : undefined;
+            if ("data" in error) {
+                errorData = error.data;
+            }
+        }
+        const logMessage = JSON.stringify({
+            level: "error",
+            type: "mcp_error",
+            timestamp,
+            tool: toolName,
+            correlationId: correlationId || generateCorrelationId(),
+            params: sanitizeParams(params),
+            success: false,
+            durationMs,
+            error: errorMessage,
+            ...(errorCode !== undefined && { errorCode }),
+            ...(errorData !== undefined && { errorData: sanitizeParams(errorData) }),
+            ...(errorStack && { stack: sanitizeStack(errorStack) }),
+        });
+        fileLogger.log(logMessage);
+    }
+    catch (logError) {
+        // Silently fail logging to prevent breaking the application
+        console.error(`[LOG ERROR] Failed to log MCP error: ${logError instanceof Error ? logError.message : String(logError)}`);
+    }
+}
+/**
+ * Wraps an MCP tool handler with request/response logging
+ */
+export function withLogging(toolName, logLevel, handler) {
+    return async (params) => {
+        const correlationId = generateCorrelationId();
+        const context = { toolName, logLevel, correlationId };
+        const startTime = Date.now();
+        // Log request
+        logMcpRequest(context, params);
+        try {
+            // Execute handler
+            const result = await handler(params);
+            const durationMs = Date.now() - startTime;
+            // Log successful response
+            logMcpResponse(context, params, result, durationMs);
+            return result;
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            // Log error response
+            logMcpError(context, params, error, durationMs);
+            // Re-throw error
+            throw error;
+        }
+    };
+}
+/**
+ * Sanitizes parameters to remove sensitive data
+ */
+function sanitizeParams(params) {
+    try {
+        if (!params || typeof params !== "object") {
+            return params;
+        }
+        const sanitized = {};
+        const sensitiveKeys = ["apiKey", "secret", "password", "token", "authorization"];
+        for (const [key, value] of Object.entries(params)) {
+            const lowerKey = key.toLowerCase();
+            if (sensitiveKeys.some((sk) => lowerKey.includes(sk))) {
+                sanitized[key] = "<redacted>";
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    catch (error) {
+        // If sanitization fails, return a safe fallback
+        return { error: "Failed to sanitize params", original: String(params) };
+    }
+}
+/**
+ * Sanitizes result to prevent logging huge responses
+ */
+function sanitizeResult(result) {
+    try {
+        if (!result) {
+            return result;
+        }
+        // If result is a string, check if it's JSON and limit size
+        if (typeof result === "string") {
+            if (result.length > 10000) {
+                return result.substring(0, 10000) + "... [truncated]";
+            }
+            return result;
+        }
+        // If result is an object with content array (MCP response format)
+        if (typeof result === "object" && result !== null) {
+            const obj = result;
+            if (Array.isArray(obj.content)) {
+                const sanitizedContent = obj.content.map((item) => {
+                    if (typeof item === "object" && item !== null) {
+                        const itemObj = item;
+                        if (typeof itemObj.text === "string" && itemObj.text.length > 10000) {
+                            return {
+                                ...itemObj,
+                                text: itemObj.text.substring(0, 10000) + "... [truncated]",
+                            };
+                        }
+                    }
+                    return item;
+                });
+                return {
+                    ...obj,
+                    content: sanitizedContent,
+                };
+            }
+        }
+        // For other objects, stringify and limit size
+        try {
+            const jsonStr = JSON.stringify(result);
+            if (jsonStr.length > 10000) {
+                return JSON.parse(jsonStr.substring(0, 10000) + '..."}');
+            }
+            return result;
+        }
+        catch {
+            return result;
+        }
+    }
+    catch (error) {
+        // If sanitization fails, return a safe fallback
+        return { error: "Failed to sanitize result", type: typeof result };
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/mcp/logging.js.map

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

package/dist/mcp/prompts.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SpotClient } from "../private/SpotClient.js";
+import { PublicClient } from "../public/PublicClient.js";
+import { AppConfig } from "../config.js";
+/**
+ * Registers MCP prompts for common Zebpay trading workflows.
+ * Prompts help LLMs understand common use cases and provide structured guidance.
+ */
+export declare function registerPrompts(server: McpServer, spot: SpotClient | null, publicClient: PublicClient, config: AppConfig): void;