@robinmordasiewicz/f5xc-api-mcp 1.0.82-2512312028

package/dist/utils/error-handling.js

@@ -0,0 +1,239 @@
+/**
+ * Error handling utilities for F5XC API MCP Server
+ *
+ * Provides typed error classes for different error scenarios
+ * and utilities for error categorization and handling.
+ */
+/**
+ * Base error class for F5XC API errors
+ */
+export class F5XCError extends Error {
+    /** Error code for categorization */
+    code;
+    /** Additional error context */
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.name = "F5XCError";
+        this.code = code;
+        this.context = context;
+        // Maintains proper stack trace for where our error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, F5XCError);
+        }
+    }
+    /**
+     * Convert error to JSON representation
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+        };
+    }
+}
+/**
+ * Authentication-related errors
+ */
+export class AuthenticationError extends F5XCError {
+    constructor(message, context) {
+        super(message, "AUTH_ERROR", context);
+        this.name = "AuthenticationError";
+    }
+}
+/**
+ * API request/response errors
+ */
+export class F5XCApiError extends F5XCError {
+    /** HTTP status code */
+    status;
+    /** Raw API response */
+    response;
+    constructor(message, status, response, context) {
+        super(message, "API_ERROR", context);
+        this.name = "F5XCApiError";
+        this.status = status;
+        this.response = response;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            status: this.status,
+            response: this.response,
+        };
+    }
+}
+/**
+ * Configuration errors
+ */
+export class ConfigurationError extends F5XCError {
+    constructor(message, context) {
+        super(message, "CONFIG_ERROR", context);
+        this.name = "ConfigurationError";
+    }
+}
+/**
+ * Validation errors for request parameters
+ */
+export class ValidationError extends F5XCError {
+    /** Field-level validation errors */
+    errors;
+    constructor(message, errors, context) {
+        super(message, "VALIDATION_ERROR", context);
+        this.name = "ValidationError";
+        this.errors = errors;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            errors: this.errors,
+        };
+    }
+}
+/**
+ * Tool execution errors
+ */
+export class ToolExecutionError extends F5XCError {
+    /** Name of the tool that failed */
+    toolName;
+    constructor(toolName, message, context) {
+        super(message, "TOOL_ERROR", context);
+        this.name = "ToolExecutionError";
+        this.toolName = toolName;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            toolName: this.toolName,
+        };
+    }
+}
+/**
+ * OpenAPI specification errors
+ */
+export class SpecificationError extends F5XCError {
+    constructor(message, context) {
+        super(message, "SPEC_ERROR", context);
+        this.name = "SpecificationError";
+    }
+}
+/**
+ * Error categorization for MCP responses
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    /** User input validation errors */
+    ErrorCategory["VALIDATION"] = "validation";
+    /** Authentication/authorization errors */
+    ErrorCategory["AUTHENTICATION"] = "authentication";
+    /** Server-side errors */
+    ErrorCategory["SERVER"] = "server";
+    /** Network/connectivity errors */
+    ErrorCategory["NETWORK"] = "network";
+    /** Configuration errors */
+    ErrorCategory["CONFIGURATION"] = "configuration";
+    /** Unknown errors */
+    ErrorCategory["UNKNOWN"] = "unknown";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Categorize an error for appropriate handling
+ */
+export function categorizeError(error) {
+    if (error instanceof ValidationError) {
+        return ErrorCategory.VALIDATION;
+    }
+    if (error instanceof AuthenticationError) {
+        return ErrorCategory.AUTHENTICATION;
+    }
+    if (error instanceof ConfigurationError) {
+        return ErrorCategory.CONFIGURATION;
+    }
+    if (error instanceof F5XCApiError) {
+        if (error.status !== undefined) {
+            if (error.status === 401 || error.status === 403) {
+                return ErrorCategory.AUTHENTICATION;
+            }
+            if (error.status >= 400 && error.status < 500) {
+                return ErrorCategory.VALIDATION;
+            }
+            if (error.status >= 500) {
+                return ErrorCategory.SERVER;
+            }
+        }
+        return ErrorCategory.SERVER;
+    }
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        if (message.includes("network") ||
+            message.includes("timeout") ||
+            message.includes("econnrefused") ||
+            message.includes("enotfound")) {
+            return ErrorCategory.NETWORK;
+        }
+    }
+    return ErrorCategory.UNKNOWN;
+}
+/**
+ * Format error for MCP tool response
+ */
+export function formatErrorForMcp(error) {
+    const category = categorizeError(error);
+    let errorMessage;
+    let errorCode;
+    let details;
+    if (error instanceof F5XCError) {
+        errorMessage = error.message;
+        errorCode = error.code;
+        details = error.context;
+    }
+    else if (error instanceof Error) {
+        errorMessage = error.message;
+        errorCode = "UNKNOWN_ERROR";
+    }
+    else {
+        errorMessage = String(error);
+        errorCode = "UNKNOWN_ERROR";
+    }
+    const errorResponse = {
+        error: {
+            category,
+            code: errorCode,
+            message: errorMessage,
+            details,
+        },
+    };
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(errorResponse, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Wrap async function with error handling
+ */
+export function withErrorHandling(fn) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            if (error instanceof F5XCError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                throw new F5XCError(error.message, "UNKNOWN_ERROR", {
+                    originalError: error.name,
+                    stack: error.stack,
+                });
+            }
+            throw new F5XCError(String(error), "UNKNOWN_ERROR");
+        }
+    };
+}
+//# sourceMappingURL=error-handling.js.map

package/dist/utils/error-handling.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utils Module - Export all utility functions
+ */
+export { logger, createLogger, LogLevel } from "./logging.js";
+export type { LoggerConfig } from "./logging.js";
+export { F5XCError, AuthenticationError, F5XCApiError, ConfigurationError, ValidationError, ToolExecutionError, SpecificationError, ErrorCategory, categorizeError, formatErrorForMcp, withErrorHandling, } from "./error-handling.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Utils Module - Export all utility functions
+ */
+export { logger, createLogger, LogLevel } from "./logging.js";
+export { F5XCError, AuthenticationError, F5XCApiError, ConfigurationError, ValidationError, ToolExecutionError, SpecificationError, ErrorCategory, categorizeError, formatErrorForMcp, withErrorHandling, } from "./error-handling.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/utils/logging.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Logging utilities for F5XC API MCP Server
+ *
+ * Uses stderr for logging to avoid interfering with STDIO transport.
+ * Provides structured logging with levels and context.
+ */
+/**
+ * Log levels
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * Logger configuration
+ */
+export interface LoggerConfig {
+    /** Minimum log level to output */
+    level: LogLevel;
+    /** Include timestamp in log output */
+    timestamps: boolean;
+    /** Enable JSON format for structured logging */
+    json: boolean;
+}
+/**
+ * Logger class for structured logging to stderr
+ */
+declare class Logger {
+    private config;
+    constructor(config?: Partial<LoggerConfig>);
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Format and output a log entry
+     */
+    private log;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Set the minimum log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Readonly<LoggerConfig>;
+}
+/**
+ * Singleton logger instance
+ */
+export declare const logger: Logger;
+/**
+ * Create a child logger with additional context
+ */
+export declare function createLogger(config?: Partial<LoggerConfig>): Logger;
+export {};
+//# sourceMappingURL=logging.d.ts.map

package/dist/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAYD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,QAAQ,CAAC;IAChB,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,IAAI,EAAE,OAAO,CAAC;CACf;AAqBD;;GAEG;AACH,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAc9C;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,GAAG;IA+BX;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;CAGpC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAEnE"}

package/dist/utils/logging.js

@@ -0,0 +1,131 @@
+/**
+ * Logging utilities for F5XC API MCP Server
+ *
+ * Uses stderr for logging to avoid interfering with STDIO transport.
+ * Provides structured logging with levels and context.
+ */
+/**
+ * Log levels
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Log level priority for filtering
+ */
+const LOG_LEVEL_PRIORITY = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.WARN]: 2,
+    [LogLevel.ERROR]: 3,
+};
+/**
+ * Default logger configuration
+ */
+const DEFAULT_CONFIG = {
+    level: LogLevel.INFO,
+    timestamps: true,
+    json: false,
+};
+/**
+ * Logger class for structured logging to stderr
+ */
+class Logger {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // Check for environment variable overrides
+        const envLevel = process.env["LOG_LEVEL"]?.toLowerCase();
+        if (envLevel && Object.values(LogLevel).includes(envLevel)) {
+            this.config.level = envLevel;
+        }
+        if (process.env["LOG_JSON"] === "true") {
+            this.config.json = true;
+        }
+    }
+    /**
+     * Check if a log level should be output
+     */
+    shouldLog(level) {
+        return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.config.level];
+    }
+    /**
+     * Format and output a log entry
+     */
+    log(entry) {
+        if (!this.shouldLog(entry.level)) {
+            return;
+        }
+        if (this.config.timestamps) {
+            entry.timestamp = new Date().toISOString();
+        }
+        if (this.config.json) {
+            // Structured JSON output
+            process.stderr.write(JSON.stringify(entry) + "\n");
+        }
+        else {
+            // Human-readable output
+            const parts = [];
+            if (entry.timestamp) {
+                parts.push(`[${entry.timestamp}]`);
+            }
+            parts.push(`[${entry.level.toUpperCase()}]`);
+            parts.push(entry.message);
+            if (entry.context && Object.keys(entry.context).length > 0) {
+                parts.push(JSON.stringify(entry.context));
+            }
+            process.stderr.write(parts.join(" ") + "\n");
+        }
+    }
+    /**
+     * Log a debug message
+     */
+    debug(message, context) {
+        this.log({ level: LogLevel.DEBUG, message, context });
+    }
+    /**
+     * Log an info message
+     */
+    info(message, context) {
+        this.log({ level: LogLevel.INFO, message, context });
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, context) {
+        this.log({ level: LogLevel.WARN, message, context });
+    }
+    /**
+     * Log an error message
+     */
+    error(message, context) {
+        this.log({ level: LogLevel.ERROR, message, context });
+    }
+    /**
+     * Set the minimum log level
+     */
+    setLevel(level) {
+        this.config.level = level;
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return Object.freeze({ ...this.config });
+    }
+}
+/**
+ * Singleton logger instance
+ */
+export const logger = new Logger();
+/**
+ * Create a child logger with additional context
+ */
+export function createLogger(config) {
+    return new Logger(config);
+}
+//# sourceMappingURL=logging.js.map

package/dist/utils/logging.js.map

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

package/manifest.json

@@ -0,0 +1,143 @@
+{
+  "manifest_version": "0.3",
+  "name": "f5xc-api-mcp",
+  "display_name": "F5 Distributed Cloud API",
+  "version": "1.0.0",
+  "description": "MCP server for F5 Distributed Cloud API - AI-powered infrastructure management with 1500+ tools across 22 domains",
+  "long_description": "Enables AI assistants to manage F5 Distributed Cloud resources including HTTP load balancers, origin pools, WAF policies, DNS zones, and multi-cloud sites. Works in dual mode: documentation mode (no auth) or execution mode (with auth). Every response includes equivalent f5xcctl CLI commands and Terraform HCL examples.",
+  "author": {
+    "name": "Robin Mordasiewicz"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/robinmordasiewicz/f5xc-api-mcp.git"
+  },
+  "homepage": "https://github.com/robinmordasiewicz/f5xc-api-mcp",
+  "documentation": "https://robinmordasiewicz.github.io/f5xc-api-mcp",
+  "support": "https://github.com/robinmordasiewicz/f5xc-api-mcp/issues",
+  "keywords": [
+    "mcp",
+    "f5",
+    "f5xc",
+    "distributed-cloud",
+    "api",
+    "infrastructure",
+    "load-balancer",
+    "waf",
+    "dns",
+    "terraform",
+    "ai"
+  ],
+  "license": "MIT",
+  "compatibility": {
+    "claude_desktop": ">=1.0.0",
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  },
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/dist/index.js"],
+      "env": {
+        "F5XC_API_URL": "${user_config.f5xc_api_url}",
+        "F5XC_API_TOKEN": "${user_config.f5xc_api_token}",
+        "F5XC_P12_FILE": "${user_config.f5xc_p12_file}",
+        "F5XC_P12_PASSWORD": "${user_config.f5xc_p12_password}",
+        "LOG_LEVEL": "${user_config.log_level}"
+      }
+    }
+  },
+  "user_config": {
+    "f5xc_api_url": {
+      "type": "string",
+      "title": "F5XC Tenant URL",
+      "description": "F5 Distributed Cloud tenant URL (e.g., https://your-tenant.console.ves.volterra.io)",
+      "required": false
+    },
+    "f5xc_api_token": {
+      "type": "string",
+      "title": "API Token",
+      "description": "API token for authentication (optional - runs in documentation mode without)",
+      "sensitive": true,
+      "required": false
+    },
+    "f5xc_p12_file": {
+      "type": "file",
+      "title": "P12 Certificate File",
+      "description": "Path to P12 certificate for mTLS authentication (alternative to API token)",
+      "required": false
+    },
+    "f5xc_p12_password": {
+      "type": "string",
+      "title": "P12 Password",
+      "description": "Password for P12 certificate",
+      "sensitive": true,
+      "required": false
+    },
+    "log_level": {
+      "type": "string",
+      "title": "Log Level",
+      "description": "Logging verbosity (debug, info, warn, error)",
+      "default": "info",
+      "required": false
+    }
+  },
+  "tools": [
+    {
+      "name": "f5xc-api-server-info",
+      "description": "Get server information and authentication status"
+    },
+    {
+      "name": "f5xc-api-search-tools",
+      "description": "Search for F5XC API tools using natural language"
+    },
+    {
+      "name": "f5xc-api-describe-tool",
+      "description": "Get detailed information about a specific tool"
+    },
+    {
+      "name": "f5xc-api-execute-tool",
+      "description": "Execute an F5XC API tool"
+    },
+    {
+      "name": "f5xc-api-search-resources",
+      "description": "Search for F5XC resources"
+    },
+    {
+      "name": "f5xc-api-execute-resource",
+      "description": "Execute CRUD operation on a resource"
+    }
+  ],
+  "tools_generated": true,
+  "prompts": [
+    {
+      "name": "deploy-http-loadbalancer",
+      "description": "Guided workflow for deploying HTTP Load Balancer with origin pool",
+      "arguments": ["namespace", "name"],
+      "text": "Deploy an HTTP Load Balancer named ${arguments.name} in namespace ${arguments.namespace}"
+    },
+    {
+      "name": "configure-waf",
+      "description": "Guided workflow for configuring Web Application Firewall",
+      "arguments": ["namespace"],
+      "text": "Configure WAF protection in namespace ${arguments.namespace}"
+    },
+    {
+      "name": "create-multicloud-site",
+      "description": "Guided workflow for deploying F5XC site in AWS/Azure/GCP",
+      "arguments": ["provider", "region"],
+      "text": "Create a multi-cloud site on ${arguments.provider} in ${arguments.region}"
+    },
+    {
+      "name": "generate-terraform",
+      "description": "Export F5XC resources as Terraform configuration",
+      "arguments": ["resource_type", "namespace"],
+      "text": "Generate Terraform for ${arguments.resource_type} resources in ${arguments.namespace}"
+    }
+  ],
+  "prompts_generated": false
+}