@robinmordasiewicz/f5xc-api-mcp 3.0.0

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
+}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@robinmordasiewicz/f5xc-api-mcp",
+  "version": "3.0.0",
+  "description": "F5 Distributed Cloud API MCP Server - Exposes F5XC APIs to AI assistants via Model Context Protocol",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "f5xc-api-mcp": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "sync-specs": "tsx scripts/sync-specs.ts",
+    "generate": "tsx scripts/generate.ts",
+    "generate-docs": "tsx scripts/generate-docs.ts",
+    "prepare": "npm run build",
+    "bundle": "mcpb pack",
+    "bundle:validate": "mcpb validate"
+  },
+  "keywords": [
+    "f5",
+    "xc",
+    "f5xc",
+    "distributed-cloud",
+    "mcp",
+    "model-context-protocol",
+    "api",
+    "load-balancer",
+    "waf",
+    "dns",
+    "ai-tools"
+  ],
+  "author": "Robin Mordasiewicz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/robinmordasiewicz/f5xc-api-mcp.git"
+  },
+  "homepage": "https://robinmordasiewicz.github.io/f5xc-api-mcp",
+  "bugs": {
+    "url": "https://github.com/robinmordasiewicz/f5xc-api-mcp/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "devDependencies": {
+    "@anthropic-ai/mcpb": "^2.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "globals": "^16.5.0",
+    "prettier": "^3.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.16"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/node": "^25.0.0",
+    "axios": "^1.7.0",
+    "https-proxy-agent": "^7.0.0",
+    "jszip": "^3.10.0",
+    "yaml": "^2.4.0",
+    "zod": "^4.0.0"
+  }
+}