@lionad/port-key-mcp 0.2.0 → 0.4.1

package/README.md

@@ -1,84 +1,139 @@
-# PortKey
+# PortKey MCP Server
 
-<p align="center">
-  <img width="200" src="/public/logo.png" />
-</p>
+## Description
 
-<p align="center">
-  <strong>PortKey：A Simple, Practical Port Naming Strategy</strong>
-</p>
+[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.
 
-<p align="center">
-  <!-- LANGUAGES=("cn" "es" "fr" "de" "ja" "ko" "ru" "ar" "pt" "it") -->
-  <a href="./docs/README.cn.md">中文</a> | <a href="./docs/README.es.md">Español</a> | <a href="./docs/README.fr.md">Français</a> | <a href="./docs/README.de.md">Deutsch</a> | <a href="./docs/README.ja.md">日本語</a> | <a href="./docs/README.ko.md">한국어</a> | <a href="./docs/README.ru.md">Русский</a> | <a href="./docs/README.ar.md">العربية</a> | <a href="./docs/README.pt.md">Português</a> | <a href="./docs/README.it.md">Italiano</a>
-</p>
+## Usage
 
-## Brief
+### Running the Server
 
-Generate ports with a letter-to-number keyboard mapping
+The PortKey MCP server supports both Stdio and Streamable HTTP transport modes.
 
-When you’re running a bunch of projects locally, picking port numbers becomes annoying.
+#### Stdio Mode (Default)
 
-- Over the last couple of years, there have been *so many* new projects. To really try them out, you often need to boot them locally—and then ports start colliding.
-- If you want to keep browser tabs (or bookmarks) stable, a project’s port shouldn’t keep changing.
+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).
 
-For example, I have more than ten Nuxt apps on my machine. If they all default to `3000`, that’s obviously not going to work. So I came up with a simple, consistent port naming rule to “assign” ports per project.
+```shell
+npx @lionad/port-key-mcp
+```
+
+#### HTTP Mode (Streamable)
+
+Runs an HTTP server implementing the Streamable HTTP transport. This mode is suitable for remote connections or when stdio is not available.
 
-[Source Blog Post](https://lionad.art/articles/simple-naming-method)
+```shell
+# Run on default port 10945
+npx @lionad/port-key-mcp --streamable
 
-### Core idea
+# Run on specific port
+npx @lionad/port-key-mcp --streamable --port 8080
 
-Instead of picking random numbers, map the **project name to numbers based on the keyboard**, so the port is *readable* and *memorable*.
+# Reuse the already-running server on the same port (default: true)
+npx @lionad/port-key-mcp --streamable --port 8080 --reuse
 
-As long as the result is within the valid port range (**1024–65535**) and doesn’t hit reserved/system ports, you can just use it.
+# 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
+```
 
-More specifically: using a standard QWERTY keyboard, map each letter to a single digit based on its **row/column position**.
+Environment variables are also supported:
+```shell
+PORT=8080 LOG_LEVEL=debug npx @lionad/port-key-mcp --streamable
+```
 
-Example:
+##### Single-instance reuse (Streamable)
 
-`"cfetch"` → `c(3) f(4) e(3) t(5) c(3) h(6)` → `34353`（port number）
+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.
 
-Then you can take the first 4 digits (e.g. `3453`), or keep more digits (e.g. `34353`). Either is fine.
+##### Endpoints (Streamable)
 
-If a project needs multiple ports (frontend, backend, database, etc.), pick **one** of these two approaches:
+- `GET /health` returns a JSON health payload.
+- `POST /mcp`, `GET /mcp`, `DELETE /mcp` implement MCP Streamable HTTP transport (stateful sessions).
 
-1. Use the project prefix, then append a “role suffix”  
-   - For `"cfetch"`, take `3435` as the base  
-   - Frontend (`fe`, i.e. `43`) → `34354`  
-   - Backend (`server`) → `34352`  
-   - Database (`mongo`) → `34357`  
-   - …and so on
+### Available Tools
 
-2. Use the project prefix, then assign sequential roles  
-   - For `"cfetch"`, take `3435` as the base  
-   - Web → `34351`  
-   - Backend → `34352`  
-   - Database → `34353`  
-   - …and so on
+The MCP server provides the following tools:
 
-### Valid port range
+- **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
 
-- Ports must be within **1024–65535** (System ports 0-1023 are blocked).
-- **System Ports (0-1023)**: Assigned by IETF. Strictly blocked.
-- **User Ports (1024-49151)**: Assigned by IANA. Use with caution as they might conflict with registered services.
-- **Dynamic/Private Ports (49152-65535)**: Not assigned. Safest for private or dynamic use.
+#### map-project-name-to-port
 
----
+##### Tool Parameters
 
-## How to use
+- `projectName` (string, required): The project name to map to a port number
+- `map` (string, optional): Custom mapping in JSON format (e.g., `{ "1": "qaz", "2": "wsx", ... }`)
+- `preferDigitCount` (number, optional): Preferred digit count for port (2-5, default: 4)
+- `minPort` (number, optional): Minimum port number (0-65535, default: 0)
+- `maxPort` (number, optional): Maximum port number (0-65535, default: 65535)
+- `blockedPorts` (array of numbers, optional): List of blocked port numbers to avoid
 
-Simple command:
+##### Example Tool Call
 
-```sh
-npx -y @lionad/port-key <your-project-name>
+```json
+{
+  "name": "map-project-name-to-port",
+  "arguments": {
+    "projectName": "cfetch",
+    "preferDigitCount": 4
+  }
+}
 ```
 
-Or you want a stdio MCP server:
+##### Example Response
 
-```sh
-npx -y @lionad/port-key-mcp
+```json
+{
+  "digits": "343536",
+  "port": 3435,
+  "rejectedCandidates": []
+}
 ```
 
+#### get-design-philosophy
+
+##### Tool Parameters
+
+- `lang` (string, optional): Language code for design philosophy content. Supported languages: `"cn"`, `"es"`, `"fr"`, `"de"`, `"ja"`, `"ko"`, `"ru"`, `"ar"`, `"pt"`, `"it"`. Default: `"cn"`.
+
+#### check-port-availability
+
+##### Tool Parameters
+
+- `port` (number, required): The port number to check (0-65535)
+
+#### get-port-occupancy
+
+##### Tool Parameters
+
+- `ports` (array of numbers, optional): List of port numbers to filter results
+
+### Available Resources
+
+- **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   |
+|-------|------------|
+| cn    | 中文        |
+| es    | Español    |
+| fr    | Français    |
+| de    | Deutsch     |
+| ja    | 日本語      |
+| ko    | 한국어       |
+| ru    | Русский     |
+| ar    | العربية     |
+| pt    | Português  |
+| it    | Italiano   |
+
+## Configuration
+
+You can configure MCP server in your MCP client's configuration file (e.g., for VS Code Copilot, configure in your `.copilot/settings.json`):
+
 ```json
 {
   "mcpServers": {
@@ -90,52 +145,49 @@ npx -y @lionad/port-key-mcp
 }
 ```
 
+For HTTP mode configuration in clients that support it:
 
-### CLI options
+```json
+{
+  "mcpServers": {
+    "port-key": {
+      "command": "npx",
+      "args": ["@lionad/port-key-mcp", "--streamable"]
+    }
+  }
+}
+```
 
-- `-m, --map <object>`: custom mapping (JSON or JS-like object literal)
-- `--lang <code>`: output language (currently only `en` and `cn`, default: `cn`)
-- `-d, --digits <count>`: preferred digit count for port (4 or 5, default: 4)
-- `-h, --help`: show help
+## Logs
 
-Examples:
+In Streamable HTTP mode, logs are written under `~/.port-key/logs`.
 
-```bash
-npx @lionad/port-key cfetch # -> 3435
-npx @lionad/port-key cfetch --digits 4  # -> 3435 (4-digit port)
-npx @lionad/port-key cfetch --digits 5  # -> 34353 (5-digit port)
-```
+## Development
 
-Notes:
-- Default log language is `cn`. Use `--lang en` to show English messages.
-- Use `-h` or `--help` to show help.
+Build locales (generates from docs/ directory):
 
-### Config
+```shell
+pnpm run build:locales
+```
 
-PortKey reads optional user config from:
+Run tests:
 
-- `~/.port-key/config.json`
+```shell
+pnpm test
+```
 
-A full Example:
+Run tests in watch mode:
 
-```json
-{
-  // Preferred digit count for port (4 or 5)
-  "preferDigitCount": 5,
-  // Custom letter-to-digit mapping
-  "blockedPorts": [3000, 3001, 3002, 6666],
-  // Port range limits (inclusive)
-  "minPort": 1024,
-  "maxPort": 49151
-}
+```shell
+pnpm run test:watch
 ```
 
----
+E2E tests live under `tests/e2e/` and are included in `pnpm test`.
 
-## For Developer
+## Thanks
 
-### Project Structure
+- **[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.
 
-- 本仓库采用 pnpm monorepo；核心包位于 `packages/core`。
-- 安装：在根目录执行 `pnpm install`。
-- 运行测试：`pnpm -C packages/core test` 或 `pnpm -C packages/core test:watch`。
+- **[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;