@lionad/port-key-mcp 0.3.0 → 0.4.1

package/dist/tools/check-port-availability.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+export const checkPortAvailabilityTool = {
+    name: "check-port-availability",
+    title: "Check Port Availability",
+    isLocal: true,
+    description: "Check if a specific port is available or occupied on the local machine. This tool executes local system commands (lsof) and will not work in cloud/serverless environments.",
+    inputSchema: {
+        port: z.number().int().min(0).max(65535),
+    },
+    execute: async ({ port }) => {
+        try {
+            // Use lsof to check port usage (works on macOS/Linux)
+            // For Windows, netstat might be needed, but assuming macOS environment as per context
+            try {
+                await execAsync(`lsof -i :${port}`);
+                // If lsof returns success (exit code 0), the port is occupied
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                port,
+                                available: false,
+                                status: "occupied",
+                                message: `Port ${port} is currently in use.`,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                // If lsof returns error (exit code 1), the port is likely free
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                port,
+                                available: true,
+                                status: "available",
+                                message: `Port ${port} appears to be available.`,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: errorMessage }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+};
+//# sourceMappingURL=check-port-availability.js.map

package/dist/tools/check-port-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-port-availability.js","sourceRoot":"","sources":["../../src/tools/check-port-availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,yBAAyB;IAC/B,KAAK,EAAE,yBAAyB;IAChC,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,6KAA6K;IAC1L,WAAW,EAAE;QACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;KACzC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAoB,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,sDAAsD;YACtD,sFAAsF;YACtF,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;gBACpC,8DAA8D;gBAC9D,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,IAAI;gCACJ,SAAS,EAAE,KAAK;gCAChB,MAAM,EAAE,UAAU;gCAClB,OAAO,EAAE,QAAQ,IAAI,uBAAuB;6BAC7C,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,+DAA+D;gBAC/D,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,IAAI;gCACJ,SAAS,EAAE,IAAI;gCACf,MAAM,EAAE,WAAW;gCACnB,OAAO,EAAE,QAAQ,IAAI,2BAA2B;6BACjD,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;qBAC9C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/get-design-philosophy.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export declare const getDesignPhilosophyTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        lang: z.ZodDefault<z.ZodEnum<{
+            [x: string]: string;
+        }>>;
+    };
+    execute: ({ lang }: any) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/get-design-philosophy.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const SUPPORTED_LANGUAGES = ["cn", "es", "fr", "de", "ja", "ko", "ru", "ar", "pt", "it"];
+async function loadLocale(lang) {
+    const localePath = join(__dirname, "..", "..", "locales", `${lang}.json`);
+    try {
+        const content = await readFile(localePath, "utf-8");
+        const locale = JSON.parse(content);
+        return locale.designPhilosophy || "";
+    }
+    catch {
+        return "";
+    }
+}
+export const getDesignPhilosophyTool = {
+    name: "get-design-philosophy",
+    title: "Get PortKey Design Philosophy",
+    description: "Get design philosophy and background of PortKey",
+    inputSchema: {
+        lang: z.enum([...SUPPORTED_LANGUAGES]).default("cn"),
+    },
+    execute: async ({ lang = "cn" }) => {
+        try {
+            const philosophy = await loadLocale(lang);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: philosophy,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error && typeof error === "object" && "message" in error ? String(error.message) : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: errorMessage }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+};
+//# sourceMappingURL=get-design-philosophy.js.map

package/dist/tools/get-design-philosophy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-design-philosophy.js","sourceRoot":"","sources":["../../src/tools/get-design-philosophy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEzF,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,+BAA+B;IACtC,WAAW,EAAE,iDAAiD;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,mBAAmB,CAA0B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;KAC9E;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,GAAG,IAAI,EAAO,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU;qBACjB;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;qBAC9C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/get-port-occupancy.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export declare const getPortOccupancyTool: {
+    name: string;
+    title: string;
+    isLocal: boolean;
+    description: string;
+    inputSchema: {
+        ports: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    };
+    execute: ({ ports }: {
+        ports?: number[];
+    }) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/get-port-occupancy.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+export const getPortOccupancyTool = {
+    name: "get-port-occupancy",
+    title: "Get Port Occupancy",
+    isLocal: true,
+    description: "Get information about processes occupying specific ports on the local machine. This tool executes local system commands (lsof) and will not work in cloud/serverless environments.",
+    inputSchema: {
+        ports: z.array(z.number().int().min(0).max(65535)).optional(),
+    },
+    execute: async ({ ports }) => {
+        try {
+            let command = "lsof -i -P -n";
+            if (ports && ports.length > 0) {
+                // Filter for specific ports if provided
+                // lsof doesn't support multiple ports easily in one go for -i without complex syntax
+                // So we'll fetch all and filter in JS, or construct a grep chain
+                // Fetching all listening ports is usually fast enough
+            }
+            const { stdout } = await execAsync(command);
+            const lines = stdout.split('\n').filter(line => line.trim() !== '');
+            const processes = [];
+            // Parse lsof output
+            // COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
+            for (let i = 1; i < lines.length; i++) {
+                const parts = lines[i].replace(/\s+/g, ' ').split(' ');
+                if (parts.length >= 9) {
+                    const namePart = parts.slice(8).join(' ');
+                    const portMatch = namePart.match(/:(\d+)/);
+                    if (portMatch) {
+                        const port = parseInt(portMatch[1], 10);
+                        if (!ports || ports.includes(port)) {
+                            processes.push({
+                                command: parts[0],
+                                pid: parts[1],
+                                user: parts[2],
+                                port,
+                                details: namePart
+                            });
+                        }
+                    }
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(processes, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: errorMessage }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+};
+//# sourceMappingURL=get-port-occupancy.js.map

package/dist/tools/get-port-occupancy.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,94 @@
+export declare const tools: ({
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        projectName: import("zod").ZodString;
+        map: import("zod").ZodOptional<import("zod").ZodString>;
+        preferDigitCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        minPort: import("zod").ZodOptional<import("zod").ZodNumber>;
+        maxPort: import("zod").ZodOptional<import("zod").ZodNumber>;
+        blockedPorts: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
+    };
+    execute: ({ projectName, map, preferDigitCount, minPort, maxPort, blockedPorts }: any) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+} | {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        lang: import("zod").ZodDefault<import("zod").ZodEnum<{
+            [x: string]: string;
+        }>>;
+    };
+    execute: ({ lang }: any) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+} | {
+    name: string;
+    title: string;
+    isLocal: boolean;
+    description: string;
+    inputSchema: {
+        port: import("zod").ZodNumber;
+    };
+    execute: ({ port }: {
+        port: number;
+    }) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+} | {
+    name: string;
+    title: string;
+    isLocal: boolean;
+    description: string;
+    inputSchema: {
+        ports: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
+    };
+    execute: ({ ports }: {
+        ports?: number[];
+    }) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+})[];

package/dist/tools/index.js

@@ -0,0 +1,11 @@
+import { mapProjectNameToPortTool } from './map-project-name-to-port.js';
+import { getDesignPhilosophyTool } from './get-design-philosophy.js';
+import { checkPortAvailabilityTool } from './check-port-availability.js';
+import { getPortOccupancyTool } from './get-port-occupancy.js';
+export const tools = [
+    mapProjectNameToPortTool,
+    getDesignPhilosophyTool,
+    checkPortAvailabilityTool,
+    getPortOccupancyTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,wBAAwB;IACxB,uBAAuB;IACvB,yBAAyB;IACzB,oBAAoB;CACrB,CAAC"}

package/dist/tools/map-project-name-to-port.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export declare const mapProjectNameToPortTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        projectName: z.ZodString;
+        map: z.ZodOptional<z.ZodString>;
+        preferDigitCount: z.ZodOptional<z.ZodNumber>;
+        minPort: z.ZodOptional<z.ZodNumber>;
+        maxPort: z.ZodOptional<z.ZodNumber>;
+        blockedPorts: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    };
+    execute: ({ projectName, map, preferDigitCount, minPort, maxPort, blockedPorts }: any) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/map-project-name-to-port.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { mapToPort } from "@lionad/port-key";
+export const mapProjectNameToPortTool = {
+    name: "map-project-name-to-port",
+    title: "Map Project Name to Port",
+    description: "Map a project name to a port number using keyboard-based letter-to-number mapping",
+    inputSchema: {
+        projectName: z.string().min(1),
+        map: z.string().optional(),
+        preferDigitCount: z.number().int().min(2).max(5).optional(),
+        minPort: z.number().int().min(0).max(65535).optional(),
+        maxPort: z.number().int().min(0).max(65535).optional(),
+        blockedPorts: z.array(z.number().int().min(0).max(65535)).optional(),
+    },
+    execute: async ({ projectName, map, preferDigitCount, minPort, maxPort, blockedPorts }) => {
+        try {
+            let customMap = undefined;
+            if (map && map !== "") {
+                customMap = JSON.parse(map);
+            }
+            const options = {
+                preferDigitCount,
+                minPort,
+                maxPort,
+                blockedPorts: blockedPorts ? new Set(blockedPorts) : undefined,
+            };
+            const result = mapToPort(projectName, customMap, options);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error && typeof error === "object" && "message" in error ? String(error.message) : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: errorMessage }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+};
+//# sourceMappingURL=map-project-name-to-port.js.map

package/dist/tools/map-project-name-to-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-project-name-to-port.js","sourceRoot":"","sources":["../../src/tools/map-project-name-to-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,mFAAmF;IAChG,WAAW,EAAE;QACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;QACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;QACtD,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;KACrE;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAO,EAAE,EAAE;QAC7F,IAAI,CAAC;YACH,IAAI,SAAS,GAAG,SAAS,CAAC;YAC1B,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;gBACtB,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,OAAO,GAAG;gBACd,gBAAgB;gBAChB,OAAO;gBACP,OAAO;gBACP,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,YAAwB,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3E,CAAC;YACF,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;qBAC9C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+import winston from 'winston';
+interface CustomLogger extends winston.Logger {
+    getLevel(): string;
+    setLevel(level: string): void;
+}
+declare const logger: CustomLogger;
+export default logger;

package/dist/utils/logger.js

@@ -0,0 +1,55 @@
+import winston from 'winston';
+import DailyRotateFile from 'winston-daily-rotate-file';
+import config from '../config/index.js';
+import { homedir } from 'os';
+import { existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+const LOG_DIR = join(homedir(), '.port-key', 'logs');
+if (!existsSync(LOG_DIR)) {
+    mkdirSync(LOG_DIR, { recursive: true });
+}
+const logger = winston.createLogger({
+    level: config.logging.level,
+    format: winston.format.combine(winston.format.timestamp(), winston.format.errors({ stack: true }), winston.format.json()),
+    transports: [
+        new DailyRotateFile({
+            filename: join(LOG_DIR, 'error-%DATE%.log'),
+            datePattern: 'YYYY-MM-DD',
+            zippedArchive: true,
+            maxSize: '10m',
+            maxFiles: '14d',
+            level: 'error',
+        }),
+        new DailyRotateFile({
+            filename: join(LOG_DIR, 'combined-%DATE%.log'),
+            datePattern: 'YYYY-MM-DD',
+            zippedArchive: true,
+            maxSize: '1',
+            maxFiles: '14d',
+        }),
+    ],
+});
+if (process.env.NODE_ENV !== 'production') {
+    logger.add(new winston.transports.Console({
+        format: winston.format.combine(winston.format.colorize(), winston.format.printf(({ timestamp, level, message, ...rest }) => {
+            let args = '';
+            if (typeof message === 'object') {
+                args = JSON.stringify(message, null, 2);
+                message = '';
+            }
+            const extraArgs = Object.keys(rest).length
+                ? JSON.stringify(rest, null, 2)
+                : '';
+            return `${timestamp} ${level}: ${message} ${args} ${extraArgs}`.trim();
+        })),
+    }));
+}
+logger.getLevel = () => logger.level;
+logger.setLevel = (level) => {
+    logger.level = level;
+    logger.transports.forEach((transport) => {
+        transport.level = level;
+    });
+};
+export default logger;
+//# 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/session-manager.d.ts

@@ -0,0 +1,35 @@
+interface SessionOptions {
+    ttl: number;
+    timeout: number;
+}
+export declare class SessionManager<T> {
+    private sessions;
+    private options;
+    private cleanupInterval;
+    constructor(options?: SessionOptions);
+    /**
+     * Set a session with the given ID and data
+     */
+    set(id: string, data: T): void;
+    /**
+     * Get a session by ID. Updates the expiration time (sliding window).
+     */
+    get(id: string): T | undefined;
+    /**
+     * Remove a session by ID
+     */
+    remove(id: string): void;
+    /**
+     * Get the number of active sessions
+     */
+    get size(): number;
+    /**
+     * Cleanup expired sessions
+     */
+    private cleanup;
+    /**
+     * Stop the cleanup interval and clear all sessions
+     */
+    destroy(): void;
+}
+export {};

package/dist/utils/session-manager.js

@@ -0,0 +1,66 @@
+import config from '../config/index.js';
+export class SessionManager {
+    sessions;
+    options;
+    cleanupInterval;
+    constructor(options = config.session) {
+        this.sessions = new Map();
+        this.options = options;
+        // Cleanup every minute to remove expired sessions
+        this.cleanupInterval = setInterval(() => this.cleanup(), 60000);
+    }
+    /**
+     * Set a session with the given ID and data
+     */
+    set(id, data) {
+        const expiresAt = Date.now() + this.options.ttl * 1000;
+        this.sessions.set(id, { data, expiresAt });
+    }
+    /**
+     * Get a session by ID. Updates the expiration time (sliding window).
+     */
+    get(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            return undefined;
+        // Check if expired
+        if (Date.now() > session.expiresAt) {
+            this.sessions.delete(id);
+            return undefined;
+        }
+        // Refresh expiration
+        session.expiresAt = Date.now() + this.options.ttl * 1000;
+        return session.data;
+    }
+    /**
+     * Remove a session by ID
+     */
+    remove(id) {
+        this.sessions.delete(id);
+    }
+    /**
+     * Get the number of active sessions
+     */
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * Cleanup expired sessions
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [id, session] of this.sessions.entries()) {
+            if (now > session.expiresAt) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+    /**
+     * Stop the cleanup interval and clear all sessions
+     */
+    destroy() {
+        clearInterval(this.cleanupInterval);
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/utils/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/utils/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAYxC,MAAM,OAAO,cAAc;IACjB,QAAQ,CAAiC;IACzC,OAAO,CAAiB;IACxB,eAAe,CAAiB;IAExC,YAAY,UAA0B,MAAM,CAAC,OAAO;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,kDAAkD;QAClD,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU,EAAE,IAAO;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,mBAAmB;QACnB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,qBAAqB;QACrB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;QACzD,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,GAAG,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionad/port-key-mcp",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "MCP Server for PortKey",
   "bin": "./bin/port-key-mcp.js",
   "type": "module",
@@ -46,14 +46,20 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@lionad/port-key": "^0.1.5",
-    "@modelcontextprotocol/sdk": "^1.24.1",
-    "zod": "^4.1.13"
+    "@fastify/cors": "^11.2.0",
+    "@lionad/port-key": "^0.3.0",
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "dotenv": "^17.2.3",
+    "fastify": "^5.6.2",
+    "winston": "^3.19.0",
+    "winston-daily-rotate-file": "^5.0.0",
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@cfworker/json-schema": "^4.1.1",
+    "@types/dotenv": "^8.2.3",
     "@types/express": "^5.0.6",
-    "@types/node": "^24.7.2",
+    "@types/node": "^24.10.7",
     "vitest": "4.0.16"
   },
   "scripts": {