@mseep/safe-omada-mcp 0.17.0

package/dist/types/omadaSiteSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omadaSiteSummary.js","sourceRoot":"","sources":["../../src/types/omadaSiteSummary.ts"],"names":[],"mappings":""}

package/dist/types/oswStackDetail.d.ts

@@ -0,0 +1,11 @@
+export interface OswStackDetail {
+    id?: string;
+    name?: string;
+    siteId?: string;
+    masterMac?: string;
+    stackDevice?: boolean;
+    member?: Array<Record<string, unknown>>;
+    ports?: Array<Record<string, unknown>>;
+    lags?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+}

package/dist/types/oswStackDetail.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=oswStackDetail.js.map

package/dist/types/oswStackDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oswStackDetail.js","sourceRoot":"","sources":["../../src/types/oswStackDetail.ts"],"names":[],"mappings":""}

package/dist/types/paginatedResult.d.ts

@@ -0,0 +1,6 @@
+export interface PaginatedResult<T> {
+    totalRows?: number;
+    currentPage?: number;
+    currentSize?: number;
+    data?: T[];
+}

package/dist/types/paginatedResult.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=paginatedResult.js.map

package/dist/types/paginatedResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginatedResult.js","sourceRoot":"","sources":["../../src/types/paginatedResult.ts"],"names":[],"mappings":""}

package/dist/types/rateLimitProfile.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Rate limit profile information from Omada API
+ */
+export interface RateLimitProfile {
+    /** Profile ID */
+    id: string;
+    /** Profile name (1-64 characters) */
+    name: string;
+    /** Whether download limit is enabled */
+    downLimitEnable: boolean;
+    /** Download limit in Kbps (when downLimitEnable is true) */
+    downLimit?: number;
+    /** Whether upload limit is enabled */
+    upLimitEnable: boolean;
+    /** Upload limit in Kbps (when upLimitEnable is true) */
+    upLimit?: number;
+}
+/**
+ * Client rate limit setting
+ */
+export interface ClientRateLimitSetting {
+    /** Rate limit profile ID (null when using custom rate limit) */
+    rateLimitId?: string | null;
+    /** Whether rate limit is enabled */
+    enable: boolean;
+    /** Whether upload limit is enabled (for custom rate limit) */
+    upEnable?: boolean;
+    /** Upload limit in Kbps (for custom rate limit) */
+    upLimit?: number;
+    /** Whether download limit is enabled (for custom rate limit) */
+    downEnable?: boolean;
+    /** Download limit in Kbps (for custom rate limit) */
+    downLimit?: number;
+}
+/**
+ * Request to update client rate limit setting
+ */
+export interface UpdateClientRateLimitRequest {
+    /** Mode: 0 = custom rate limit, 1 = use rate limit profile */
+    mode: 0 | 1;
+    /** Rate limit profile ID (required when mode = 1) */
+    rateLimitProfileId?: string;
+    /** Custom rate limit settings (required when mode = 0) */
+    customRateLimit?: {
+        /** Whether rate limit is enabled */
+        enable: boolean;
+        /** Whether upload limit is enabled */
+        upEnable?: boolean;
+        /** Upload limit in Kbps */
+        upLimit?: number;
+        /** Whether download limit is enabled */
+        downEnable?: boolean;
+        /** Download limit in Kbps */
+        downLimit?: number;
+    };
+}

package/dist/types/rateLimitProfile.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rateLimitProfile.js.map

package/dist/types/rateLimitProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitProfile.js","sourceRoot":"","sources":["../../src/types/rateLimitProfile.ts"],"names":[],"mappings":""}

package/dist/types/threatInfo.d.ts

@@ -0,0 +1,37 @@
+export interface ThreatInfo {
+    id?: string;
+    omadacId?: string;
+    siteId?: string;
+    siteName?: string;
+    time?: number;
+    severity?: number;
+    service?: string;
+    signature?: string;
+    category?: number;
+    activity?: string;
+    dataUsage?: number;
+    srcIp?: string;
+    dstIp?: string;
+    srcCountry?: string;
+    dstCountry?: string;
+    protocol?: string;
+    sid?: number;
+    srcLatitude?: number;
+    srcLongitude?: number;
+    dstLatitude?: number;
+    dstLongitude?: number;
+    archived?: boolean;
+    classification?: string;
+    createTime?: number;
+}
+export interface GetThreatListOptions {
+    siteList?: string;
+    archived: boolean;
+    page: number;
+    pageSize: number;
+    startTime: number;
+    endTime: number;
+    severity?: number;
+    sortTime?: 'asc' | 'desc';
+    searchKey?: string;
+}

package/dist/types/threatInfo.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=threatInfo.js.map

package/dist/types/threatInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threatInfo.js","sourceRoot":"","sources":["../../src/types/threatInfo.ts"],"names":[],"mappings":""}

package/dist/types/tokenResult.d.ts

@@ -0,0 +1,6 @@
+export interface TokenResult {
+    accessToken: string;
+    tokenType: string;
+    expiresIn: number;
+    refreshToken?: string;
+}

package/dist/types/tokenResult.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tokenResult.js.map

package/dist/types/tokenResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenResult.js","sourceRoot":"","sources":["../../src/types/tokenResult.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export type { OmadaApiResponse } from './types/omadaApiResponse.js';
+export type { OmadaClientInfo } from './types/omadaClientInfo.js';
+export type { OmadaDeviceInfo } from './types/omadaDeviceInfo.js';
+export type { OmadaSiteSummary } from './types/omadaSiteSummary.js';
+export type { PaginatedResult } from './types/paginatedResult.js';
+export type { TokenResult } from './types/tokenResult.js';

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/config-validations.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Configuration validation utilities
+ * All environment variable validation logic should be centralized here
+ */
+/**
+ * Validates IPv4 addresses
+ * @param value - The string to validate
+ * @returns true if valid IPv4 address, false otherwise
+ */
+export declare function isValidIpv4Address(value: string): boolean;
+/**
+ * Validates IPv6 addresses
+ * @param value - The string to validate
+ * @returns true if valid IPv6 address, false otherwise
+ */
+export declare function isValidIpv6Address(value: string): boolean;
+/**
+ * Validates IPv4 or IPv6 addresses
+ * @param value - The string to validate
+ * @returns true if valid IP address, false otherwise
+ */
+export declare function isValidIpAddress(value: string): boolean;
+/**
+ * Validates hostnames according to RFC standards
+ * @param value - The string to validate
+ * @returns true if valid hostname, false otherwise
+ */
+export declare function isValidHostname(value: string): boolean;
+/**
+ * Validates allowed origin values (hostname, IPv4, IPv6, or wildcard)
+ * @param value - The string to validate
+ * @returns true if valid origin, false otherwise
+ */
+export declare function isValidOrigin(value: string): boolean;
+/**
+ * Validates bind address (must be a valid IP address)
+ * @param value - The string to validate
+ * @returns true if valid bind address, false otherwise
+ */
+export declare function isValidBindAddress(value: string): boolean;
+/**
+ * Returns true when the bind address is loopback-only.
+ * Used to keep the legacy HTTP transport confined to local lab/debug use.
+ */
+export declare function isLoopbackBindAddress(value: string): boolean;
+/**
+ * Validates an array of origin values
+ * @param origins - Array of origin strings to validate
+ * @returns Object with isValid flag and optional error message
+ */
+export declare function validateOrigins(origins: string[]): {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Validates bind address with detailed error message
+ * @param bindAddr - The bind address to validate
+ * @returns Object with isValid flag and optional error message
+ */
+export declare function validateBindAddress(bindAddr: string): {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Validates and resolves port number with fallback
+ * @param value - The port number to validate
+ * @param fallback - The fallback port number if validation fails
+ * @returns The validated port or fallback
+ */
+export declare function resolvePort(value: number | undefined, fallback: number): number;
+/**
+ * Normalizes path by ensuring it starts with / and doesn't end with /
+ * @param path - The path to normalize
+ * @returns The normalized path
+ */
+export declare function normalizePath(path: string): string;

package/dist/utils/config-validations.js

@@ -0,0 +1,133 @@
+/**
+ * Configuration validation utilities
+ * All environment variable validation logic should be centralized here
+ */
+import { isIPv4, isIPv6 } from 'node:net';
+/**
+ * Validates IPv4 addresses
+ * @param value - The string to validate
+ * @returns true if valid IPv4 address, false otherwise
+ */
+export function isValidIpv4Address(value) {
+    return isIPv4(value);
+}
+/**
+ * Validates IPv6 addresses
+ * @param value - The string to validate
+ * @returns true if valid IPv6 address, false otherwise
+ */
+export function isValidIpv6Address(value) {
+    return isIPv6(value);
+}
+/**
+ * Validates IPv4 or IPv6 addresses
+ * @param value - The string to validate
+ * @returns true if valid IP address, false otherwise
+ */
+export function isValidIpAddress(value) {
+    return isValidIpv4Address(value) || isValidIpv6Address(value);
+}
+/**
+ * Validates hostnames according to RFC standards
+ * @param value - The string to validate
+ * @returns true if valid hostname, false otherwise
+ */
+export function isValidHostname(value) {
+    // Check for special case of localhost
+    if (value === 'localhost') {
+        return true;
+    }
+    // Check if it's an IP address (should not be considered a hostname)
+    if (isValidIpAddress(value)) {
+        return false;
+    }
+    // Hostname regex following RFC 1123
+    const hostnameRegex = /^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)*[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?$/;
+    return hostnameRegex.test(value);
+}
+/**
+ * Validates allowed origin values (hostname, IPv4, IPv6, or wildcard)
+ * @param value - The string to validate
+ * @returns true if valid origin, false otherwise
+ */
+export function isValidOrigin(value) {
+    // Allow wildcard to disable origin validation
+    if (value === '*') {
+        return true;
+    }
+    return isValidIpAddress(value) || isValidHostname(value);
+}
+/**
+ * Validates bind address (must be a valid IP address)
+ * @param value - The string to validate
+ * @returns true if valid bind address, false otherwise
+ */
+export function isValidBindAddress(value) {
+    return isValidIpAddress(value);
+}
+/**
+ * Returns true when the bind address is loopback-only.
+ * Used to keep the legacy HTTP transport confined to local lab/debug use.
+ */
+export function isLoopbackBindAddress(value) {
+    return value === '127.0.0.1' || value === '::1';
+}
+/**
+ * Validates an array of origin values
+ * @param origins - Array of origin strings to validate
+ * @returns Object with isValid flag and optional error message
+ */
+export function validateOrigins(origins) {
+    for (const origin of origins) {
+        if (!isValidOrigin(origin)) {
+            return {
+                isValid: false,
+                error: `Invalid origin: ${origin}`,
+            };
+        }
+    }
+    return { isValid: true };
+}
+/**
+ * Validates bind address with detailed error message
+ * @param bindAddr - The bind address to validate
+ * @returns Object with isValid flag and optional error message
+ */
+export function validateBindAddress(bindAddr) {
+    if (!isValidBindAddress(bindAddr)) {
+        return {
+            isValid: false,
+            error: `Invalid bind address: ${bindAddr}. Must be a valid IPv4 or IPv6 address.`,
+        };
+    }
+    return { isValid: true };
+}
+/**
+ * Validates and resolves port number with fallback
+ * @param value - The port number to validate
+ * @param fallback - The fallback port number if validation fails
+ * @returns The validated port or fallback
+ */
+export function resolvePort(value, fallback) {
+    if (!value) {
+        return fallback;
+    }
+    if (!Number.isInteger(value) || value <= 0 || value > 65_535) {
+        return fallback;
+    }
+    return value;
+}
+/**
+ * Normalizes path by ensuring it starts with / and doesn't end with /
+ * @param path - The path to normalize
+ * @returns The normalized path
+ */
+export function normalizePath(path) {
+    const startsWithSlash = path.startsWith('/') ? path : `/${path}`;
+    if (startsWithSlash.length > 1 && startsWithSlash.endsWith('/')) {
+        const trimmed = startsWithSlash.replace(/\/+$/, '');
+        return trimmed.length === 0 ? '/' : trimmed;
+    }
+    return startsWithSlash;
+}
+//# sourceMappingURL=config-validations.js.map

package/dist/utils/config-validations.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,18 @@
+type LogFields = Record<string, unknown>;
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+type LogFormat = 'plain' | 'json' | 'gcp-json';
+/**
+ * Initialize the logger with a specific log level and format.
+ * This should be called once during application startup.
+ * @param level - The minimum log level to output
+ * @param format - The output format (plain, json, or gcp-json)
+ * @param useStderr - If true, logs to stderr instead of stdout (required for stdio transport)
+ */
+export declare function initLogger(level: LogLevel, format?: LogFormat, useStderr?: boolean): void;
+export declare const logger: {
+    debug(message: string, meta?: LogFields): void;
+    info(message: string, meta?: LogFields): void;
+    warn(message: string, meta?: LogFields): void;
+    error(message: string, meta?: LogFields): void;
+};
+export {};

package/dist/utils/logger.js

@@ -0,0 +1,91 @@
+import pino from 'pino';
+const levelToSeverity = {
+    trace: 'DEBUG',
+    debug: 'DEBUG',
+    info: 'INFO',
+    warn: 'WARNING',
+    error: 'ERROR',
+    fatal: 'CRITICAL',
+};
+let instance;
+function createLogger(level = 'info', format = 'plain', useStderr = false) {
+    const baseConfig = {
+        level,
+        base: undefined,
+        messageKey: 'message',
+        timestamp: pino.stdTimeFunctions.isoTime,
+    };
+    // Configure formatters based on format
+    if (format === 'gcp-json') {
+        baseConfig.formatters = {
+            level(label) {
+                return { severity: levelToSeverity[label] ?? label.toUpperCase() };
+            },
+        };
+    }
+    else if (format === 'plain') {
+        // For plain format, we still output JSON but could be enhanced with pino-pretty
+        // For now, using JSON output with a note that pino-pretty can be added as optional dependency
+        baseConfig.formatters = {
+            level(label) {
+                return { level: label.toUpperCase() };
+            },
+        };
+    }
+    // For 'json' format, use default pino JSON output (no special formatters)
+    // When running in stdio mode, always log to stderr to avoid interfering with MCP protocol on stdout
+    // Pass stderr as the destination stream (second parameter to pino constructor)
+    return useStderr ? pino(baseConfig, process.stderr) : pino(baseConfig);
+}
+// Initialize with default, will be reconfigured by calling initLogger
+// Read log level from environment for tests
+const defaultLevel = process.env.MCP_SERVER_LOG_LEVEL ?? 'info';
+instance = createLogger(defaultLevel);
+/**
+ * Initialize the logger with a specific log level and format.
+ * This should be called once during application startup.
+ * @param level - The minimum log level to output
+ * @param format - The output format (plain, json, or gcp-json)
+ * @param useStderr - If true, logs to stderr instead of stdout (required for stdio transport)
+ */
+export function initLogger(level, format = 'plain', useStderr = false) {
+    instance = createLogger(level, format, useStderr);
+}
+function normalizeMeta(meta) {
+    if (!meta) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(meta)) {
+        if (value instanceof Error) {
+            normalized[key] = { message: value.message, stack: value.stack };
+            continue;
+        }
+        normalized[key] = value;
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function write(level, message, meta) {
+    const fields = normalizeMeta(meta);
+    if (fields) {
+        instance[level](fields, message);
+    }
+    else {
+        instance[level](message);
+    }
+}
+export const logger = {
+    debug(message, meta) {
+        write('debug', message, meta);
+    },
+    info(message, meta) {
+        write('info', message, meta);
+    },
+    warn(message, meta) {
+        write('warn', message, meta);
+    },
+    error(message, meta) {
+        write('error', message, meta);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/pagination-schema.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+/**
+ * Standard Omada API pagination parameters.
+ * All paginated Omada API endpoints require both page and pageSize parameters.
+ *
+ * According to the API specification:
+ * - page: Start page number. Start from 1. (required)
+ * - pageSize: Number of entries per page. Range: 1-1000. (required)
+ *
+ * @param defaultPageSize - Default page size to use (default: 10)
+ * @returns Zod object shape with page and pageSize fields
+ */
+export declare function createPaginationSchema(defaultPageSize?: number): {
+    page: z.ZodDefault<z.ZodNumber>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+};
+/**
+ * Type representing the pagination parameters shape.
+ */
+export interface PaginationParams {
+    page: number;
+    pageSize: number;
+}

package/dist/utils/pagination-schema.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/**
+ * Standard Omada API pagination parameters.
+ * All paginated Omada API endpoints require both page and pageSize parameters.
+ *
+ * According to the API specification:
+ * - page: Start page number. Start from 1. (required)
+ * - pageSize: Number of entries per page. Range: 1-1000. (required)
+ *
+ * @param defaultPageSize - Default page size to use (default: 10)
+ * @returns Zod object shape with page and pageSize fields
+ */
+export function createPaginationSchema(defaultPageSize = 10) {
+    return {
+        page: z.number().int().min(1).default(1).describe('Start page number. Start from 1.'),
+        pageSize: z.number().int().min(1).max(1000).default(defaultPageSize).describe('Number of entries per page. Range: 1-1000.'),
+    };
+}
+//# sourceMappingURL=pagination-schema.js.map

package/dist/utils/pagination-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-schema.js","sourceRoot":"","sources":["../../src/utils/pagination-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,eAAe,GAAG,EAAE;IACvD,OAAO;QACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KAC9H,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@mseep/safe-omada-mcp",
+  "version": "0.17.0",
+  "description": "Security-focused Model Context Protocol server for TP-Link Omada Open API workflows",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "safe-omada-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "biome check --error-on-warnings .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "check": "npm run lint && tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "inspector": "tsx scripts/run-inspector.ts",
+    "inspector:build": "npm run build && tsx scripts/run-inspector.ts build",
+    "docker:build": "docker build -f Dockerfile -t ghcr.io/gaspareduard/omada-mcp:latest .",
+    "docker:run": "docker run --rm -it --env-file .env --env-file .env.local ghcr.io/gaspareduard/omada-mcp:latest",
+    "docker:push": "docker push ghcr.io/gaspareduard/omada-mcp:latest",
+    "prepare": "husky"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "README.Docker.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    ".env.example"
+  ],
+  "keywords": [
+    "mcp",
+    "tp-link",
+    "omada",
+    "mseep",
+    "mcp-server"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "author": "gaspareduard",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gaspareduard/Omada-mcp.git"
+  },
+  "homepage": "https://github.com/gaspareduard/Omada-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/gaspareduard/Omada-mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.21.0",
+    "axios": "^1.13.2",
+    "dotenv": "^17.2.3",
+    "pino": "^10.1.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.6",
+    "@modelcontextprotocol/inspector": "^0.21.1",
+    "@types/node": "^24.10.0",
+    "@vitest/coverage-v8": "^4.0.10",
+    "@vitest/ui": "^4.0.8",
+    "concurrently": "^9.1.0",
+    "husky": "^9.1.7",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.8"
+  },
+  "publisher": "mseep"
+}