@lionad/port-key-mcp 0.3.0 → 0.4.2

package/README.md

@@ -2,32 +2,62 @@
 
 ## Description
 
-[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for PortKey. It provides tools to map project names to port numbers using keyboard-based letter-to-number mapping and get design philosophy.
+[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for PortKey. It provides tools to map project names to port numbers using keyboard-based letter-to-number mapping, check port availability, and access PortKey configuration.
 
-## Installation
+## Usage
+
+### Running the Server
+
+The PortKey MCP server supports both Stdio and Streamable HTTP transport modes.
 
-Install MCP server package:
+#### Stdio Mode (Default)
+
+Designed to be run by an IDE-based MCP client like [Visual Studio Code's Copilot](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).
 
 ```shell
-npm install @lionad/port-key-mcp
+npx @lionad/port-key-mcp
 ```
 
-## Usage
+#### HTTP Mode (Streamable)
 
-### Running the Server
+Runs an HTTP server implementing the Streamable HTTP transport. This mode is suitable for remote connections or when stdio is not available.
+
+```shell
+# Run on default port 10945
+npx @lionad/port-key-mcp --streamable
 
-The PortKey MCP server is designed to be run by an IDE-based MCP client like [Visual Studio Code's Copilot](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).
+# Run on specific port
+npx @lionad/port-key-mcp --streamable --port 8080
+
+# Reuse the already-running server on the same port (default: true)
+npx @lionad/port-key-mcp --streamable --port 8080 --reuse
+
+# Force starting a new process (will fail if the port is already in use by another service)
+npx @lionad/port-key-mcp --streamable --port 8080 --reuse false
+```
 
+Environment variables are also supported:
 ```shell
-npx @lionad/port-key-mcp
+PORT=8080 LOG_LEVEL=debug npx @lionad/port-key-mcp --streamable
 ```
 
+##### Single-instance reuse (Streamable)
+
+When you run `npx @lionad/port-key-mcp --streamable` from multiple terminals using the same port, the CLI will detect an existing PortKey MCP server (via `GET /health`) and exit successfully without starting a new server process. This keeps “one port = one MCP server instance” while allowing repeated invocations.
+
+##### Endpoints (Streamable)
+
+- `GET /health` returns a JSON health payload.
+- `POST /mcp`, `GET /mcp`, `DELETE /mcp` implement MCP Streamable HTTP transport (stateful sessions).
+
 ### Available Tools
 
-The MCP server provides following tools:
+The MCP server provides the following tools:
 
 - **map-project-name-to-port**: Map a project name to a port number using keyboard-based letter-to-number mapping
 - **get-design-philosophy**: Get design philosophy and background of PortKey
+- **check-port-availability**: Check if a specific port is available or occupied
+- **get-port-occupancy**: Get information about processes occupying specific ports
 
 #### map-project-name-to-port
 
@@ -68,29 +98,24 @@ The MCP server provides following tools:
 
 - `lang` (string, optional): Language code for design philosophy content. Supported languages: `"cn"`, `"es"`, `"fr"`, `"de"`, `"ja"`, `"ko"`, `"ru"`, `"ar"`, `"pt"`, `"it"`. Default: `"cn"`.
 
-##### Example Tool Call
+#### check-port-availability
 
-```json
-{
-  "name": "get-design-philosophy",
-  "arguments": {
-    "lang": "en"
-  }
-}
-```
+##### Tool Parameters
 
-##### Example Response
+- `port` (number, required): The port number to check (0-65535)
 
-```
-以下是 PortKey 的设计理念：
+#### get-port-occupancy
 
-## 核心思路
+##### Tool Parameters
 
-PortKey 基于键盘布局将项目名称映射为数字，使端口号既可读又易记。
-...
-```
+- `ports` (array of numbers, optional): List of port numbers to filter results
+
+### Available Resources
 
-##### Supported Languages
+- **config://port-mapping**: Get default port mapping configuration and blocked ports
+- **projects://{projectName}/port-history**: Get history of port assignments for a project
+
+### Supported Languages (for design philosophy)
 
 | Code | Language   |
 |-------|------------|
@@ -120,22 +145,49 @@ You can configure MCP server in your MCP client's configuration file (e.g., for
 }
 ```
 
+For HTTP mode configuration in clients that support it:
+
+```json
+{
+  "mcpServers": {
+    "port-key": {
+      "command": "npx",
+      "args": ["@lionad/port-key-mcp", "--streamable"]
+    }
+  }
+}
+```
+
+## Logs
+
+In Streamable HTTP mode, logs are written under `~/.port-key/logs`.
+
 ## Development
 
 Build locales (generates from docs/ directory):
 
 ```shell
-npm run build:locales
+pnpm run build:locales
 ```
 
 Run tests:
 
 ```shell
-npm test
+pnpm test
 ```
 
 Run tests in watch mode:
 
 ```shell
-npm run test:watch
+pnpm run test:watch
 ```
+
+E2E tests live under `tests/e2e/` and are included in `pnpm test`.
+
+## Thanks
+
+- **[Template-Nodejs-MCP-Server](https://github.com/HarveyYifanLi/Template-Nodejs-MCP-Server)** by HarveyYifanLi
+  - Provided excellent examples of stateful session management and modular tool/resource architecture.
+
+- **[mcp-restaurant-booking](https://github.com/modelcontextprotocol/typescript-sdk/tree/main/servers/restaurant)** by Model Context Protocol
+  - Provided reference for production-grade TypeScript project configuration and logging systems.

package/dist/config/index.d.ts

@@ -0,0 +1,26 @@
+interface LoggingConfig {
+    level: string;
+}
+interface ServerConfig {
+    port: number;
+    streamable: boolean;
+}
+interface SessionConfig {
+    ttl: number;
+    timeout: number;
+}
+interface HealthConfig {
+    enableDiskCheck: boolean;
+    enableMemoryCheck: boolean;
+    enableSessionCheck: boolean;
+    diskThreshold: number;
+    memoryThreshold: number;
+}
+interface Config {
+    logging: LoggingConfig;
+    server: ServerConfig;
+    session: SessionConfig;
+    health: HealthConfig;
+}
+declare const config: Config;
+export default config;

package/dist/config/index.js

@@ -0,0 +1,24 @@
+import dotenv from 'dotenv';
+dotenv.config();
+const config = {
+    logging: {
+        level: process.env.LOG_LEVEL || 'info',
+    },
+    server: {
+        port: process.env.PORT ? parseInt(process.env.PORT, 10) : 10945,
+        streamable: process.env.STREAMABLE === 'true' || process.env.STREAMABLE === '1',
+    },
+    session: {
+        ttl: parseInt(process.env.SESSION_TTL || '3600', 10),
+        timeout: parseInt(process.env.SESSION_TIMEOUT || '300000', 10),
+    },
+    health: {
+        enableDiskCheck: process.env.ENABLE_DISK_CHECK !== 'false',
+        enableMemoryCheck: process.env.ENABLE_MEMORY_CHECK !== 'false',
+        enableSessionCheck: process.env.ENABLE_SESSION_CHECK !== 'false',
+        diskThreshold: parseInt(process.env.DISK_THRESHOLD || '1024', 10),
+        memoryThreshold: parseInt(process.env.MEMORY_THRESHOLD || '512', 10),
+    },
+};
+export default config;
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,EAAE,CAAC;AA+BhB,MAAM,MAAM,GAAW;IACrB,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;KACvC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK;QAC/D,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,GAAG;KAChF;IACD,OAAO,EAAE;QACP,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EAAE,EAAE,CAAC;QACpD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,EAAE,EAAE,CAAC;KAC/D;IACD,MAAM,EAAE;QACN,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,OAAO;QAC1D,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,OAAO;QAC9D,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO;QAChE,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC;QACjE,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,EAAE,EAAE,CAAC;KACrE;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/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/logger.js

@@ -0,0 +1,48 @@
+import winston from 'winston';
+import DailyRotateFile from 'winston-daily-rotate-file';
+import config from './config/index.js';
+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: 'logs/error-%DATE%.log',
+            datePattern: 'YYYY-MM-DD',
+            zippedArchive: true,
+            maxSize: '10m',
+            maxFiles: '14d',
+            level: 'error',
+        }),
+        new DailyRotateFile({
+            filename: 'logs/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/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,eAAe,MAAM,2BAA2B,CAAC;AACxD,OAAO,MAAM,MAAM,mBAAmB,CAAC;AAOvC,MAAM,MAAM,GAAiB,OAAO,CAAC,YAAY,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;IAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACtC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACtB;IACD,UAAU,EAAE;QACV,IAAI,eAAe,CAAC;YAClB,QAAQ,EAAE,uBAAuB;YACjC,WAAW,EAAE,YAAY;YACzB,aAAa,EAAE,IAAI;YACnB,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,OAAO;SACf,CAAC;QACF,IAAI,eAAe,CAAC;YAClB,QAAQ,EAAE,0BAA0B;YACpC,WAAW,EAAE,YAAY;YACzB,aAAa,EAAE,IAAI;YACnB,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH;CACF,CAAiB,CAAC;AAEnB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;YAC/D,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxC,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;gBACxC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/B,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,GAAG,SAAS,IAAI,KAAK,KAAK,OAAO,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC;QACzE,CAAC,CAAC,CACH;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,QAAQ,GAAG,GAAW,EAAE,CAAC,MAAM,CAAC,KAAe,CAAC;AACvD,MAAM,CAAC,QAAQ,GAAG,CAAC,KAAa,EAAQ,EAAE;IACxC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACtC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/mcp-cli.js

@@ -1,13 +1,85 @@
-import { mcpServer } from "./mcp-server.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-function disconnect() {
-    mcpServer.close();
-    process.exitCode = 0;
-}
-await mcpServer.connect(new StdioServerTransport());
-// ! never use console.log in stdio MCP servers, but stderr is safe
-// @see https://modelcontextprotocol.io/docs/develop/build-server#logging-in-mcp-servers-2
-console.error(`PortKey MCP server is running. cwd: ${process.cwd()}`);
-process.on("SIGINT", disconnect);
-process.on("SIGTERM", disconnect);
+import { mcpServerApp } from "./mcp-server.js";
+import config from "./config/index.js";
+// Parse command line arguments
+const args = process.argv.slice(2);
+const options = {};
+function printHelp() {
+    console.log(`
+Usage: port-key-mcp [options]
+
+Options:
+  -s, --streamable       Run in streamable mode (HTTP)
+  -p, --port <number>    Specify port number (default: 10945)
+  -l, --local [boolean]  Enable/disable local tools (default: true)
+  --reuse [boolean]      Reuse existing streamable server on same port (default: true)
+  -h, --help             Show this help message
+
+Examples:
+  port-key-mcp --streamable --port 8080
+  port-key-mcp --local false
+`);
+}
+for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+        printHelp();
+        process.exit(0);
+    }
+    else if (arg === "--streamable" || arg === "-s") {
+        options.streamable = true;
+    }
+    else if (arg === "--port" || arg === "-p") {
+        const port = parseInt(args[i + 1], 10);
+        if (!isNaN(port)) {
+            options.port = port;
+            i++; // Skip next argument
+        }
+    }
+    else if (arg === "--local" || arg === "-l") {
+        options.local = args[i + 1] !== 'false';
+        if (args[i + 1] === 'true' || args[i + 1] === 'false') {
+            i++; // Skip next argument if it's a boolean value
+        }
+    }
+    else if (arg === "--reuse") {
+        options.reuse = args[i + 1] !== "false";
+        if (args[i + 1] === "true" || args[i + 1] === "false") {
+            i++;
+        }
+    }
+}
+function resolvePort() {
+    if (typeof options.port === "number")
+        return options.port;
+    const envPort = process.env.PORT ? parseInt(process.env.PORT, 10) : NaN;
+    if (!Number.isNaN(envPort))
+        return envPort;
+    return config.server.port;
+}
+async function isPortKeyMcpServerRunning(port) {
+    try {
+        const res = await fetch(`http://127.0.0.1:${port}/health`, {
+            signal: AbortSignal.timeout(1000),
+            headers: { Accept: "application/json" },
+        });
+        if (!res.ok)
+            return false;
+        const body = await res.json().catch(() => null);
+        return Boolean(body && typeof body === "object" && body.status === "ok");
+    }
+    catch {
+        return false;
+    }
+}
+const shouldRunStreamable = options.streamable || config.server.streamable;
+const reuseEnabled = options.reuse !== false;
+if (shouldRunStreamable && reuseEnabled) {
+    const port = resolvePort();
+    const running = await isPortKeyMcpServerRunning(port);
+    if (running) {
+        console.log(`PortKey MCP Server already running at http://127.0.0.1:${port}`);
+        process.exit(0);
+    }
+}
+await mcpServerApp.run(options);
 //# sourceMappingURL=mcp-cli.js.map

package/dist/mcp-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-cli.js","sourceRoot":"","sources":["../src/mcp-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,SAAS,UAAU;IAClB,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAEpD,mEAAmE;AACnE,0FAA0F;AAC1F,OAAO,CAAC,KAAK,CAAC,uCAAuC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAEtE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACjC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC"}
+{"version":3,"file":"mcp-cli.js","sourceRoot":"","sources":["../src/mcp-cli.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server.d.ts

@@ -1,3 +1,17 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-declare const mcpServer: McpServer;
-export { mcpServer };
+export declare class MCPServerApp {
+    private server;
+    constructor();
+    private createServer;
+    private registerTools;
+    private registerResources;
+    getMcpServer(): McpServer;
+    runStdio(): Promise<void>;
+    runHttp(port?: number): Promise<void>;
+    run(options?: {
+        streamable?: boolean;
+        port?: number;
+        local?: boolean;
+    }): Promise<void>;
+}
+export declare const mcpServerApp: MCPServerApp;