port-manager-mcp 1.0.0

package/README.md

@@ -0,0 +1,160 @@
+# github-kb-mcp
+
+Personal GitHub Knowledge Base MCP server. Store, search, and manage your favorite GitHub repos with JSON files.
+
+No SQLite. No API keys. No external services. Just pure JSON in → structured JSON out.
+
+## Install
+
+```bash
+npm install -g github-kb-mcp
+```
+
+## Usage
+
+### Claude Desktop / Cursor / OpenCode
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "github-kb": {
+      "command": "npx",
+      "args": ["-y", "github-kb-mcp"]
+    }
+  }
+}
+```
+
+## Tools
+
+### `add_repo` — Add a GitHub Project
+
+Add a GitHub project to your knowledge base. Automatically parses owner/name from URL.
+
+**Input:**
+```json
+{
+  "url": "https://github.com/owner/repo",
+  "description": "A test project",
+  "language": "TypeScript",
+  "tags": ["test", "demo"],
+  "purpose": "Learning MCP",
+  "install_cmd": "npm install",
+  "usage_cmd": "npm run dev",
+  "status": "active",
+  "notes": "Great project"
+}
+```
+
+**Output:**
+```json
+{
+  "success": true,
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "owner": "owner",
+  "name": "repo"
+}
+```
+
+### `search_repos` — Search Projects
+
+Search the knowledge base with keyword, language, tag, and status filters.
+
+**Input:**
+```json
+{
+  "query": "test",
+  "language": "TypeScript",
+  "tag": "demo",
+  "status": "active",
+  "limit": 20,
+  "offset": 0
+}
+```
+
+### `get_repo` — Get Project by ID
+
+Get full details of a single project.
+
+**Input:**
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000"
+}
+```
+
+### `update_repo` — Update Project
+
+Update partial fields of a project. Only pass fields you want to change.
+
+**Input:**
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "description": "Updated description",
+  "status": "archived"
+}
+```
+
+### `delete_repo` — Delete Project
+
+Delete a project from the knowledge base.
+
+**Input:**
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000"
+}
+```
+
+### `get_stats` — Get Statistics
+
+Get knowledge base statistics.
+
+**Output:**
+```json
+{
+  "total_repos": 42,
+  "by_language": { "TypeScript": 15, "Python": 10, "Rust": 8 },
+  "by_status": { "active": 30, "archived": 5, "reference": 7 },
+  "by_tag": { "mcp": 12, "api": 8, "test": 5 }
+}
+```
+
+## Supported Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `url` | string | ✅ | GitHub project URL |
+| `description` | string | ❌ | Project description |
+| `language` | string | ❌ | Primary programming language |
+| `tags` | string[] | ❌ | Category tags |
+| `purpose` | string | ❌ | Why save this project |
+| `install_cmd` | string | ❌ | Install command |
+| `usage_cmd` | string | ❌ | Usage command |
+| `status` | enum | ❌ | active, archived, reference, wip |
+| `notes` | string | ❌ | Free-form notes |
+
+## Data Storage
+
+All data is stored in `data/github-kb.json` — a simple JSON file that you can:
+- Edit with any text editor
+- Commit to Git for version control
+- Backup by copying the file
+- Share with others
+
+## Design
+
+| Feature | Why |
+|---------|-----|
+| Zero DB | No SQLite, no setup, instant startup |
+| Zero API keys | No GitHub API needed, you manage the data |
+| JSON file storage | Human-readable, Git-friendly, easy to backup |
+| Single file | Easy to maintain, easy to audit |
+| UUID-based IDs | No auto-increment conflicts |
+
+## License
+
+MIT

package/_test_debug_tmp.js

@@ -0,0 +1 @@
+const { createServer } = require('net'); const s = createServer(); s.listen(59876, '127.0.0.1', () => { console.log('listening'); }); setInterval(() => {}, 60000);

package/_test_server_tmp.js

@@ -0,0 +1,11 @@
+
+    const { createServer } = require('net');
+    const s = createServer();
+    s.listen(19876, '127.0.0.1', () => {
+      process.send({ ready: true });
+    });
+    // Keep alive
+    process.on('message', (msg) => {
+      if (msg === 'close') { s.close(); process.exit(0); }
+    });
+  

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { resolve } from 'node:path';
+import { createInterface } from 'node:readline';
+// ============================================================
+// MCP Client — for testing port-manager-mcp server
+// ============================================================
+class MCPClient {
+    mcp;
+    transport = null;
+    constructor() {
+        this.mcp = new Client({ name: 'port-manager-client', version: '1.0.0' }, { capabilities: {} });
+    }
+    async connectToServer(serverPath) {
+        this.transport = new StdioClientTransport({
+            command: process.execPath,
+            args: [serverPath],
+        });
+        await this.mcp.connect(this.transport);
+        const toolsResult = await this.mcp.listTools();
+        console.error('Connected! Available tools:');
+        for (const tool of toolsResult.tools) {
+            console.error(`  - ${tool.name}: ${tool.description?.slice(0, 80)}...`);
+        }
+    }
+    async callTool(name, args) {
+        const result = await this.mcp.callTool({
+            name,
+            arguments: args,
+        });
+        const content = result.content;
+        for (const item of content) {
+            if (item.type === 'text' && item.text) {
+                console.log(item.text);
+            }
+        }
+    }
+    async cleanup() {
+        await this.mcp.close();
+    }
+}
+// ============================================================
+// CLI Entry Point
+// ============================================================
+async function main() {
+    const serverPath = process.argv[2] ?? resolve(process.cwd(), 'dist/index.js');
+    const client = new MCPClient();
+    try {
+        await client.connectToServer(serverPath);
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        console.log('\nPort Manager MCP Client Started!');
+        console.log('');
+        console.log('Quick mode — just type JSON:');
+        console.log('  check_port {"port": 3000}');
+        console.log('  find_free_port {"start": 3000, "end": 3010}');
+        console.log('  kill_process {"port": 3000}');
+        console.log('');
+        console.log('Type "quit" to exit.');
+        console.log('');
+        for await (const line of rl) {
+            if (line.toLowerCase() === 'quit')
+                break;
+            if (!line.trim())
+                continue;
+            try {
+                const trimmed = line.trim();
+                const spaceIdx = trimmed.indexOf(' ');
+                const toolName = spaceIdx > 0 ? trimmed.slice(0, spaceIdx) : trimmed;
+                const argsStr = spaceIdx > 0 ? trimmed.slice(spaceIdx + 1) : '{}';
+                const args = JSON.parse(argsStr);
+                console.error(`\n→ Calling "${toolName}" with:`, JSON.stringify(args, null, 2));
+                await client.callTool(toolName, args);
+                console.log('\nReady for next command.');
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error('Error:', message);
+            }
+        }
+        rl.close();
+    }
+    finally {
+        await client.cleanup();
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { createServer } from 'node:net';
+import { exec } from 'node:child_process';
+import { platform } from 'node:os';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+// ============================================================
+// Constants
+// ============================================================
+const DEFAULT_PORT_RANGE = { start: 3000, end: 9000 };
+const DEFAULT_FIND_COUNT = 5;
+// ============================================================
+// Port Utilities
+// ============================================================
+/** Check if a port is available (not in use) */
+function isPortFree(port, host = '127.0.0.1') {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.listen(port, host, () => {
+            server.close(() => resolve(true));
+        });
+        server.on('error', () => resolve(false));
+    });
+}
+/** Find process info using a port number (cross-platform) */
+async function findProcessByPort(port) {
+    const os = platform();
+    try {
+        if (os === 'win32') {
+            // Windows: netstat to find PID, then tasklist for process name
+            const { stdout } = await execAsync(`netstat -ano | findstr :${port} | findstr LISTENING`);
+            const lines = stdout.trim().split('\n').filter(Boolean);
+            if (lines.length === 0)
+                return null;
+            // Parse PID from last column
+            const parts = lines[0].trim().split(/\s+/);
+            const pid = parseInt(parts[parts.length - 1], 10);
+            if (isNaN(pid))
+                return null;
+            // Get process name
+            try {
+                const { stdout: taskOut } = await execAsync(`tasklist /FI "PID eq ${pid}" /NH`);
+                const taskLine = taskOut.trim().split('\n')[0];
+                const taskParts = taskLine.trim().split(/\s+/);
+                const name = taskParts[0] || 'unknown';
+                return { pid, name, command: taskLine.trim() };
+            }
+            catch {
+                return { pid, name: 'unknown', command: `PID ${pid}` };
+            }
+        }
+        else {
+            // macOS/Linux: lsof
+            const { stdout } = await execAsync(`lsof -i :${port} -P -n | grep LISTEN`);
+            const lines = stdout.trim().split('\n').filter(Boolean);
+            if (lines.length === 0)
+                return null;
+            const parts = lines[0].trim().split(/\s+/);
+            const name = parts[0] || 'unknown';
+            const pid = parseInt(parts[1], 10);
+            const command = lines[0].trim();
+            return { pid: isNaN(pid) ? 0 : pid, name, command };
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/** Kill a process by PID (cross-platform) */
+async function killProcessByPid(pid, force = true) {
+    const os = platform();
+    if (os === 'win32') {
+        const flag = force ? '/F' : '';
+        await execAsync(`taskkill /PID ${pid} ${flag}`);
+    }
+    else {
+        const signal = force ? '-9' : '-15';
+        await execAsync(`kill ${signal} ${pid}`);
+    }
+}
+// ============================================================
+// MCP Server
+// ============================================================
+const server = new McpServer({
+    name: 'port-manager',
+    version: '1.0.0',
+});
+// ===== Tool 1: check_port =====
+server.registerTool('check_port', {
+    title: 'Check Port Status',
+    description: 'Check if a port is available or in use. Returns process info if occupied.',
+    inputSchema: z.object({
+        port: z.number().int().min(1).max(65535).describe('Port number to check'),
+        host: z.string().default('127.0.0.1').describe('Host to check (default: 127.0.0.1)'),
+    }),
+}, async ({ port, host }) => {
+    try {
+        const isFree = await isPortFree(port, host);
+        if (isFree) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ port, host, status: 'free' }, null, 2),
+                    }],
+            };
+        }
+        // Port is in use — find the process
+        const processInfo = await findProcessByPort(port);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        port,
+                        host,
+                        status: 'in_use',
+                        process: processInfo,
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: true, message }, null, 2) }],
+            isError: true,
+        };
+    }
+});
+// ===== Tool 2: find_free_port =====
+server.registerTool('find_free_port', {
+    title: 'Find Free Ports',
+    description: 'Find available ports in a given range.',
+    inputSchema: z.object({
+        start: z.number().int().min(1).max(65535).default(DEFAULT_PORT_RANGE.start).describe('Start of port range'),
+        end: z.number().int().min(1).max(65535).default(DEFAULT_PORT_RANGE.end).describe('End of port range'),
+        count: z.number().int().min(1).max(100).default(DEFAULT_FIND_COUNT).describe('Number of free ports to find'),
+    }),
+}, async ({ start, end, count }) => {
+    try {
+        if (start > end) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: true, message: 'start must be <= end' }, null, 2) }],
+                isError: true,
+            };
+        }
+        const freePorts = [];
+        for (let port = start; port <= end && freePorts.length < count; port++) {
+            if (await isPortFree(port)) {
+                freePorts.push(port);
+            }
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        requested: count,
+                        found: freePorts.length,
+                        ports: freePorts,
+                        range: { start, end },
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: true, message }, null, 2) }],
+            isError: true,
+        };
+    }
+});
+// ===== Tool 3: kill_process =====
+server.registerTool('kill_process', {
+    title: 'Kill Process by Port',
+    description: 'Kill the process occupying a specific port.',
+    inputSchema: z.object({
+        port: z.number().int().min(1).max(65535).describe('Port number to free up'),
+        force: z.boolean().default(true).describe('Force kill (SIGKILL / taskkill /F)'),
+    }),
+}, async ({ port, force }) => {
+    try {
+        // First check if port is actually in use
+        const isFree = await isPortFree(port);
+        if (isFree) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ success: false, message: `Port ${port} is not in use` }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        // Find the process
+        const processInfo = await findProcessByPort(port);
+        if (!processInfo) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ success: false, message: `Could not find process on port ${port}` }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        // Kill it
+        await killProcessByPid(processInfo.pid, force);
+        // Verify
+        const stillInUse = !await isPortFree(port);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: !stillInUse,
+                        killed_pid: processInfo.pid,
+                        killed_name: processInfo.name,
+                        port,
+                        message: stillInUse ? 'Process killed but port still in use' : `Successfully killed process ${processInfo.pid} (${processInfo.name}) on port ${port}`,
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: true, message }, null, 2) }],
+            isError: true,
+        };
+    }
+});
+// ============================================================
+// Start
+// ============================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('port-manager-mcp server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+process.on('SIGINT', async () => {
+    await server.close();
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AAEjC,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;AACrD,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAE5B,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAE/D,gDAAgD;AAChD,SAAS,UAAU,CAAC,IAAY,EAAE,IAAI,GAAG,WAAW;IAClD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC7B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,6DAA6D;AAC7D,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAA;IAErB,IAAI,CAAC;QACH,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACnB,+DAA+D;YAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,2BAA2B,IAAI,sBAAsB,CAAC,CAAA;YACzF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YAEnC,6BAA6B;YAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACjD,IAAI,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAA;YAE3B,mBAAmB;YACnB,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,wBAAwB,GAAG,OAAO,CAAC,CAAA;gBAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;gBACtC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAA;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE,CAAA;YACxD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oBAAoB;YACpB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,YAAY,IAAI,sBAAsB,CAAC,CAAA;YAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YAEnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;YAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAClC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YAC/B,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QACrD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAK,GAAG,IAAI;IACvD,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAA;IAErB,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;QAC9B,MAAM,SAAS,CAAC,iBAAiB,GAAG,IAAI,IAAI,EAAE,CAAC,CAAA;IACjD,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;QACnC,MAAM,SAAS,CAAC,QAAQ,MAAM,IAAI,GAAG,EAAE,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,iCAAiC;AACjC,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;IACE,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,2EAA2E;IACxF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KACrF,CAAC;CACH,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE3C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC9D,CAAC;aACH,CAAA;QACH,CAAC;QAED,oCAAoC;QACpC,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAEjD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,IAAI;wBACJ,IAAI;wBACJ,MAAM,EAAE,QAAQ;wBAChB,OAAO,EAAE,WAAW;qBACrB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACpF,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;AACH,CAAC,CACF,CAAA;AAED,qCAAqC;AACrC,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;IACE,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,wCAAwC;IACrD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAC3G,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACrG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC7G,CAAC;CACH,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;IAC9B,IAAI,CAAC;QACH,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC5G,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,MAAM,SAAS,GAAa,EAAE,CAAA;QAE9B,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,GAAG,IAAI,SAAS,CAAC,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YACvE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACtB,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,SAAS,EAAE,KAAK;wBAChB,KAAK,EAAE,SAAS,CAAC,MAAM;wBACvB,KAAK,EAAE,SAAS;wBAChB,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;qBACtB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACpF,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;AACH,CAAC,CACF,CAAA;AAED,mCAAmC;AACnC,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;IACE,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,6CAA6C;IAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC3E,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KAChF,CAAC;CACH,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,yCAAyC;QACzC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBACzF,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,mBAAmB;QACnB,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA;QACjD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kCAAkC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBACrG,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,UAAU;QACV,MAAM,gBAAgB,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAE9C,SAAS;QACT,MAAM,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;QAE1C,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,CAAC,UAAU;wBACpB,UAAU,EAAE,WAAW,CAAC,GAAG;wBAC3B,WAAW,EAAE,WAAW,CAAC,IAAI;wBAC7B,IAAI;wBACJ,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,+BAA+B,WAAW,CAAC,GAAG,KAAK,WAAW,CAAC,IAAI,aAAa,IAAI,EAAE;qBACtJ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACpF,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;AACH,CAAC,CACF,CAAA;AAED,+DAA+D;AAC/D,QAAQ;AACR,+DAA+D;AAE/D,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAA;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA;AAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/test-runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/test-runner.d.ts.map

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

package/dist/test-runner.js

@@ -0,0 +1,138 @@
+// Test runner for port-manager-mcp
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { resolve, join } from 'node:path';
+import { exec, spawn } from 'node:child_process';
+import { unlinkSync, existsSync } from 'node:fs';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+async function runTest(name, toolName, args, check) {
+    const serverPath = resolve(process.cwd(), 'dist/index.js');
+    const transport = new StdioClientTransport({
+        command: process.execPath,
+        args: [serverPath],
+    });
+    const mcp = new Client({ name: 'test-runner', version: '1.0.0' }, { capabilities: {} });
+    try {
+        await mcp.connect(transport);
+        const result = await mcp.callTool({ name: toolName, arguments: args });
+        const content = result.content;
+        const text = content[0]?.text ?? '';
+        const json = JSON.parse(text);
+        if (check(json)) {
+            console.log(`  ✅ ${name}`);
+            return true;
+        }
+        else {
+            console.log(`  ❌ ${name} — check failed`);
+            console.log('  Response:', JSON.stringify(json, null, 2).slice(0, 200));
+            return false;
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.log(`  ❌ ${name} — ${message}`);
+        return false;
+    }
+    finally {
+        await mcp.close();
+    }
+}
+async function main() {
+    console.log('Running port-manager-mcp tests...\n');
+    let passed = 0;
+    let failed = 0;
+    const testPort = 59876;
+    const tmpScript = join(process.cwd(), '_test_port_server_tmp.js');
+    // Test 1: check_port on a free port
+    const t1 = await runTest('check_port → free port', 'check_port', { port: testPort }, (json) => {
+        const data = json;
+        return data.status === 'free';
+    });
+    t1 ? passed++ : failed++;
+    // Test 2: find_free_port
+    const t2 = await runTest('find_free_port → find available ports', 'find_free_port', { start: 59800, end: 59850, count: 3 }, (json) => {
+        const data = json;
+        const ports = data.ports;
+        return Array.isArray(ports) && ports.length >= 1;
+    });
+    t2 ? passed++ : failed++;
+    // Test 3: find_free_port with invalid range
+    const t3 = await runTest('find_free_port → invalid range (start > end)', 'find_free_port', { start: 9000, end: 3000 }, (json) => {
+        const data = json;
+        return data.error === true;
+    });
+    t3 ? passed++ : failed++;
+    // Test 4: kill_process on a free port (should return error)
+    const t4 = await runTest('kill_process → free port (should error)', 'kill_process', { port: testPort }, (json) => {
+        const data = json;
+        return data.error === true || data.success === false;
+    });
+    t4 ? passed++ : failed++;
+    // Tests 5 & 6: Start a background server process
+    let bgServer = null;
+    try {
+        // Start a background node process that occupies the port
+        bgServer = spawn('node', ['-e', `require('net').createServer().listen(${testPort}, '127.0.0.1'); setInterval(() => {}, 60000);`], {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        bgServer.unref();
+        // Wait for port to be occupied — poll until it's in use
+        let attempts = 0;
+        while (attempts < 30) {
+            await new Promise((resolve) => setTimeout(resolve, 200));
+            const { createServer } = await import('node:net');
+            const isFree = await new Promise((resolve) => {
+                const s = createServer();
+                s.listen(testPort, '127.0.0.1', () => { s.close(); resolve(true); });
+                s.on('error', () => resolve(false));
+            });
+            if (!isFree)
+                break; // port is occupied, server is ready
+            attempts++;
+        }
+        // Test 5: check_port on occupied port
+        const t5 = await runTest('check_port → occupied port', 'check_port', { port: testPort }, (json) => {
+            const data = json;
+            return data.status === 'in_use';
+        });
+        t5 ? passed++ : failed++;
+        // Test 6: kill_process on occupied port
+        const t6 = await runTest('kill_process → kill process on port', 'kill_process', { port: testPort, force: true }, (json) => {
+            const data = json;
+            return data.success === true || data.success === false || data.error === true;
+        });
+        t6 ? passed++ : failed++;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.log(`  ❌ Test setup failed — ${message}`);
+        failed += 2;
+    }
+    finally {
+        // Cleanup background server
+        if (bgServer) {
+            try {
+                bgServer.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+        }
+        // Cleanup temp script
+        if (existsSync(tmpScript)) {
+            try {
+                unlinkSync(tmpScript);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    console.log(`\nResults: ${passed} passed, ${failed} failed`);
+    process.exit(failed > 0 ? 1 : 0);
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error('Fatal:', message);
+    process.exit(1);
+});
+//# sourceMappingURL=test-runner.js.map

package/dist/test-runner.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "port-manager-mcp",
+  "version": "1.0.0",
+  "description": "Port management MCP server — check, find, and kill processes by port number",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "port-manager-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "client": "npm run build && node dist/client.js",
+    "test": "npm run build && node dist/test-runner.js",
+    "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "release:patch": "npm version patch && npm run build && npm publish",
+    "release:minor": "npm version minor && npm run build && npm publish",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "port-manager",
+    "port-checker",
+    "kill-port",
+    "find-port"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": false
+    },
+    "zod": {
+      "optional": false
+    }
+  }
+}