@hasna/mcps 0.0.23 → 0.0.25

package/README.md

@@ -33,7 +33,7 @@ mcps --help
 - `mcps env list <server-id>`
 - `mcps env ref <server-id> API_KEY=UPSTREAM_API_KEY --source env`
 - `mcps machines list`
-- `mcps machines add --host spark01 --platform linux --arch arm64`
+- `mcps machines add --host linux-node-a --platform linux --arch arm64`
 - `mcps machines seed-defaults`
 - `mcps fleet catalog`
 - `mcps fleet health --refresh`
@@ -45,8 +45,8 @@ Use machine registration plus fleet health/install commands to manage `@hasna/*`
 MCP packages across multiple hosts over SSH.
 
 ```bash
-mcps machines add --host spark01 --username hasna --platform linux --arch arm64
-mcps machines add --host apple01 --platform darwin --arch arm64
+mcps machines add --host linux-node-a --username hasna --platform linux --arch arm64
+mcps machines add --host macos-node-a --platform darwin --arch arm64
 mcps fleet health --refresh
 mcps fleet install --yes --mode missing-or-outdated
 ```

package/bin/index.js

@@ -35599,30 +35599,30 @@ var init_machines = __esm(() => {
   init_db();
   DEFAULT_MACHINE_SEEDS = [
     {
-      id: "spark01",
-      name: "spark01",
-      host: "spark01",
+      id: "linux-node-a",
+      name: "linux-node-a",
+      host: "linux-node-a",
       platform: "linux",
       arch: "arm64"
     },
     {
-      id: "spark02",
-      name: "spark02",
-      host: "spark02",
+      id: "linux-node-b",
+      name: "linux-node-b",
+      host: "linux-node-b",
       platform: "linux",
       arch: "arm64"
     },
     {
-      id: "apple01",
-      name: "apple01",
-      host: "apple01",
+      id: "macos-node-a",
+      name: "macos-node-a",
+      host: "macos-node-a",
       platform: "darwin",
       arch: "arm64"
     },
     {
-      id: "apple03",
-      name: "apple03",
-      host: "apple03",
+      id: "macos-node-b",
+      name: "macos-node-b",
+      host: "macos-node-b",
       platform: "darwin",
       arch: "arm64"
     }
@@ -36446,7 +36446,7 @@ var init_provider_profiles = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/mcps",
-    version: "0.0.23",
+    version: "0.0.25",
     description: "Meta-MCP registry & CLI \u2014 discover, manage, and proxy MCP servers",
     type: "module",
     repository: {
@@ -41303,8 +41303,12 @@ function isStdioMode(args = process.argv.slice(2)) {
 function resolveHttpPort(args = process.argv.slice(2)) {
   for (let i = 0;i < args.length; i++) {
     const arg = args[i];
-    if (arg === "--port" && args[i + 1]) {
-      return parsePort(args[i + 1]);
+    if (arg === "--port") {
+      const value = args[i + 1];
+      if (value === undefined || value === "" || value.startsWith("--")) {
+        throw new Error("Missing value for --port");
+      }
+      return parsePort(value);
     }
     if (arg.startsWith("--port=")) {
       return parsePort(arg.slice("--port=".length));
@@ -41317,7 +41321,11 @@ function resolveHttpPort(args = process.argv.slice(2)) {
   return DEFAULT_HTTP_PORT;
 }
 function parsePort(raw) {
-  const port = Number.parseInt(raw, 10);
+  const normalized = raw.trim();
+  if (!/^\d+$/.test(normalized)) {
+    throw new Error(`Invalid port: ${raw}`);
+  }
+  const port = Number(normalized);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw new Error(`Invalid port: ${raw}`);
   }
@@ -43902,6 +43910,145 @@ function App() {
 
 // src/cli/index.tsx
 init_version();
+
+// src/lib/status.ts
+init_config2();
+init_registry();
+init_sources();
+init_provider_profiles();
+init_machines();
+init_version();
+import { existsSync as existsSync12 } from "fs";
+import { join as join14 } from "path";
+function activeDataDirEnv() {
+  if (process.env["HASNA_MCPS_DATA_DIR"])
+    return "HASNA_MCPS_DATA_DIR";
+  if (process.env["MCPS_DATA_DIR"])
+    return "MCPS_DATA_DIR";
+  return null;
+}
+function activeDatabaseEnv() {
+  if (process.env["HASNA_MCPS_DB_PATH"])
+    return "HASNA_MCPS_DB_PATH";
+  if (process.env["MCPS_DB_PATH"])
+    return "MCPS_DB_PATH";
+  return null;
+}
+function countBy(items, getValue) {
+  const counts = {};
+  for (const item of items) {
+    const value = getValue(item);
+    if (!value)
+      continue;
+    counts[value] = (counts[value] ?? 0) + 1;
+  }
+  return counts;
+}
+function buildMcpsStatus(input) {
+  const enabledServers = input.servers.filter((server) => server.enabled).length;
+  const enabledSources = input.sources.filter((source) => source.enabled).length;
+  const enabledProfiles = input.providerProfiles.filter((profile) => profile.enabled).length;
+  const enabledMachines = input.machines.filter((machine) => machine.enabled).length;
+  const cachedTools = [...input.toolCounts.values()].reduce((sum, count) => sum + count, 0);
+  const serversWithLastError = input.servers.filter((server) => Boolean(server.last_error)).length;
+  const databaseReachable = input.databaseReachable !== false;
+  const status = databaseReachable && serversWithLastError === 0 ? "ok" : "warn";
+  return {
+    service: "mcps",
+    schemaVersion: "1.0",
+    package: {
+      name: "@hasna/mcps",
+      version: input.packageVersion ?? readPackageVersion(import.meta.url)
+    },
+    env: {
+      dataDir: {
+        primary: "HASNA_MCPS_DATA_DIR",
+        fallback: "MCPS_DATA_DIR",
+        active: activeDataDirEnv()
+      },
+      database: {
+        primary: "HASNA_MCPS_DB_PATH",
+        fallback: "MCPS_DB_PATH",
+        active: activeDatabaseEnv()
+      },
+      credentialVaultConfigured: Boolean(process.env["HASNA_MCPS_CREDENTIAL_VAULT_PATH"])
+    },
+    registry: {
+      sources: {
+        total: input.sources.length,
+        enabled: enabledSources,
+        disabled: input.sources.length - enabledSources,
+        byType: countBy(input.sources, (source) => source.type)
+      },
+      providerProfiles: {
+        total: input.providerProfiles.length,
+        enabled: enabledProfiles,
+        disabled: input.providerProfiles.length - enabledProfiles
+      }
+    },
+    cache: {
+      directoryPresent: input.cacheDirectoryPresent,
+      cachedTools,
+      serversWithCachedTools: [...input.toolCounts.values()].filter((count) => count > 0).length
+    },
+    counts: {
+      servers: {
+        total: input.servers.length,
+        enabled: enabledServers,
+        disabled: input.servers.length - enabledServers,
+        byTransport: countBy(input.servers, (server) => server.transport),
+        bySource: countBy(input.servers, (server) => server.source),
+        withLastError: serversWithLastError
+      },
+      machines: {
+        total: input.machines.length,
+        enabled: enabledMachines,
+        disabled: input.machines.length - enabledMachines
+      }
+    },
+    health: {
+      status,
+      databaseReachable,
+      hasRegisteredServers: input.servers.length > 0,
+      hasServerErrors: serversWithLastError > 0
+    },
+    safety: {
+      includesToolConfigs: false,
+      includesCommands: false,
+      includesArgs: false,
+      includesEnvValues: false,
+      includesCredentialRefs: false,
+      includesTokens: false,
+      includesPrivatePaths: false,
+      includesRegistryUrls: false,
+      statusOutputIsMetadataOnly: true
+    }
+  };
+}
+function getMcpsStatus() {
+  try {
+    return buildMcpsStatus({
+      servers: listServers(),
+      sources: listSources(),
+      providerProfiles: listProviderProfiles(),
+      machines: listMachines(),
+      toolCounts: getToolCounts(),
+      cacheDirectoryPresent: existsSync12(join14(MCPS_DIR, "cache"))
+    });
+  } catch {
+    return buildMcpsStatus({
+      servers: [],
+      sources: [],
+      providerProfiles: [],
+      machines: [],
+      toolCounts: new Map,
+      cacheDirectoryPresent: false,
+      databaseReachable: false
+    });
+  }
+}
+
+// src/cli/index.tsx
 var VERSION3 = (() => {
   return readPackageVersion(import.meta.url);
 })();
@@ -44593,21 +44740,17 @@ program2.command("info").argument("<id>", "Server ID").description("Show server
   closeDb();
 });
 program2.command("status").description("Show registry stats").option("--json", "Output as JSON").action((opts) => {
-  const servers = listServers();
-  const enabled = servers.filter((s) => s.enabled).length;
-  const disabled = servers.length - enabled;
-  const toolCounts = getToolCounts();
-  let totalTools = 0;
-  for (const s of servers)
-    totalTools += toolCounts.get(s.id) ?? 0;
+  const status = getMcpsStatus();
   if (opts.json) {
-    console.log(JSON.stringify({ total: servers.length, enabled, disabled, totalTools }, null, 2));
+    console.log(JSON.stringify(status, null, 2));
     closeDb();
     return;
   }
   console.log(chalk2.bold("Registry Status"));
-  console.log(`  Servers:  ${servers.length} (${chalk2.green(`${enabled} enabled`)}, ${chalk2.red(`${disabled} disabled`)})`);
-  console.log(`  Tools:    ${totalTools} (cached)`);
+  console.log(`  Package:  ${status.package.version}`);
+  console.log(`  Servers:  ${status.counts.servers.total} (${chalk2.green(`${status.counts.servers.enabled} enabled`)}, ${chalk2.red(`${status.counts.servers.disabled} disabled`)})`);
+  console.log(`  Sources:  ${status.registry.sources.total} (${chalk2.green(`${status.registry.sources.enabled} enabled`)}, ${chalk2.red(`${status.registry.sources.disabled} disabled`)})`);
+  console.log(`  Tools:    ${status.cache.cachedTools} (cached)`);
   closeDb();
 });
 program2.command("doctor").argument("[id]", "Server ID to check (omit to check all)").description("Diagnose server health \u2014 checks PATH, env vars, connectivity").option("--fix", "Attempt to fix issues automatically").option("--yes", "Approve probing and launching local stdio commands").option("--allow-local-stdio", "Approve probing and launching local stdio commands").option("--allow-risky-command", "Approve high-risk local command patterns").action(async (id, opts) => {

package/bin/mcp.js

@@ -34898,30 +34898,30 @@ var init_machines = __esm(() => {
   init_db();
   DEFAULT_MACHINE_SEEDS = [
     {
-      id: "spark01",
-      name: "spark01",
-      host: "spark01",
+      id: "linux-node-a",
+      name: "linux-node-a",
+      host: "linux-node-a",
       platform: "linux",
       arch: "arm64"
     },
     {
-      id: "spark02",
-      name: "spark02",
-      host: "spark02",
+      id: "linux-node-b",
+      name: "linux-node-b",
+      host: "linux-node-b",
       platform: "linux",
       arch: "arm64"
     },
     {
-      id: "apple01",
-      name: "apple01",
-      host: "apple01",
+      id: "macos-node-a",
+      name: "macos-node-a",
+      host: "macos-node-a",
       platform: "darwin",
       arch: "arm64"
     },
     {
-      id: "apple03",
-      name: "apple03",
-      host: "apple03",
+      id: "macos-node-b",
+      name: "macos-node-b",
+      host: "macos-node-b",
       platform: "darwin",
       arch: "arm64"
     }
@@ -37682,8 +37682,12 @@ function isStdioMode(args = process.argv.slice(2)) {
 function resolveHttpPort(args = process.argv.slice(2)) {
   for (let i = 0;i < args.length; i++) {
     const arg = args[i];
-    if (arg === "--port" && args[i + 1]) {
-      return parsePort(args[i + 1]);
+    if (arg === "--port") {
+      const value = args[i + 1];
+      if (value === undefined || value === "" || value.startsWith("--")) {
+        throw new Error("Missing value for --port");
+      }
+      return parsePort(value);
     }
     if (arg.startsWith("--port=")) {
       return parsePort(arg.slice("--port=".length));
@@ -37696,7 +37700,11 @@ function resolveHttpPort(args = process.argv.slice(2)) {
   return DEFAULT_HTTP_PORT;
 }
 function parsePort(raw) {
-  const port = Number.parseInt(raw, 10);
+  const normalized = raw.trim();
+  if (!/^\d+$/.test(normalized)) {
+    throw new Error(`Invalid port: ${raw}`);
+  }
+  const port = Number(normalized);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw new Error(`Invalid port: ${raw}`);
   }

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export type { McpSource, AddSourceOptions } from "./types.js";
 export { addMachine, upsertMachine, listMachines, getMachine, updateMachine, removeMachine, seedDefaultMachines, DEFAULT_MACHINE_SEEDS, } from "./lib/machines.js";
 export { listHasnaMcpCatalog, runFleetHealthCheck, runFleetInstall } from "./lib/fleet.js";
 export { readPackageVersion } from "./lib/version.js";
+export { buildMcpsStatus, getMcpsStatus } from "./lib/status.js";
+export type { McpsStatusContract } from "./lib/status.js";
 export { assertLocalCommandConsent, formatLocalCommandReview, inspectLocalCommand, LocalCommandConsentError, } from "./lib/local-command-consent.js";
 export { CredentialReferenceError, REDACTED_CREDENTIAL_VALUE, credentialRefPlaceholders, isSecretLikeEnvKey, isSecretLikeValue, normalizeCredentialRefs, normalizeCredentialRef, normalizeLiteralEnv, redactEnv, redactServerCredentials, resolveServerEnv, } from "./lib/credentials.js";
 export type { LocalCommandConsent, LocalCommandInput, LocalCommandOperation, LocalCommandReview, LocalCommandRisk, } from "./lib/local-command-consent.js";

package/dist/index.js

@@ -26857,30 +26857,30 @@ function removeMachine(id) {
 }
 var DEFAULT_MACHINE_SEEDS = [
   {
-    id: "spark01",
-    name: "spark01",
-    host: "spark01",
+    id: "linux-node-a",
+    name: "linux-node-a",
+    host: "linux-node-a",
     platform: "linux",
     arch: "arm64"
   },
   {
-    id: "spark02",
-    name: "spark02",
-    host: "spark02",
+    id: "linux-node-b",
+    name: "linux-node-b",
+    host: "linux-node-b",
     platform: "linux",
     arch: "arm64"
   },
   {
-    id: "apple01",
-    name: "apple01",
-    host: "apple01",
+    id: "macos-node-a",
+    name: "macos-node-a",
+    host: "macos-node-a",
     platform: "darwin",
     arch: "arm64"
   },
   {
-    id: "apple03",
-    name: "apple03",
-    host: "apple03",
+    id: "macos-node-b",
+    name: "macos-node-b",
+    host: "macos-node-b",
     platform: "darwin",
     arch: "arm64"
   }
@@ -27612,6 +27612,138 @@ function readPackageVersion(moduleUrl, fallback = FALLBACK_VERSION) {
   }
   return fallback;
 }
+// src/lib/status.ts
+init_config2();
+import { existsSync as existsSync12 } from "fs";
+import { join as join13 } from "path";
+init_sources();
+function activeDataDirEnv() {
+  if (process.env["HASNA_MCPS_DATA_DIR"])
+    return "HASNA_MCPS_DATA_DIR";
+  if (process.env["MCPS_DATA_DIR"])
+    return "MCPS_DATA_DIR";
+  return null;
+}
+function activeDatabaseEnv() {
+  if (process.env["HASNA_MCPS_DB_PATH"])
+    return "HASNA_MCPS_DB_PATH";
+  if (process.env["MCPS_DB_PATH"])
+    return "MCPS_DB_PATH";
+  return null;
+}
+function countBy(items, getValue) {
+  const counts = {};
+  for (const item of items) {
+    const value = getValue(item);
+    if (!value)
+      continue;
+    counts[value] = (counts[value] ?? 0) + 1;
+  }
+  return counts;
+}
+function buildMcpsStatus(input) {
+  const enabledServers = input.servers.filter((server) => server.enabled).length;
+  const enabledSources = input.sources.filter((source) => source.enabled).length;
+  const enabledProfiles = input.providerProfiles.filter((profile) => profile.enabled).length;
+  const enabledMachines = input.machines.filter((machine) => machine.enabled).length;
+  const cachedTools = [...input.toolCounts.values()].reduce((sum, count) => sum + count, 0);
+  const serversWithLastError = input.servers.filter((server) => Boolean(server.last_error)).length;
+  const databaseReachable = input.databaseReachable !== false;
+  const status = databaseReachable && serversWithLastError === 0 ? "ok" : "warn";
+  return {
+    service: "mcps",
+    schemaVersion: "1.0",
+    package: {
+      name: "@hasna/mcps",
+      version: input.packageVersion ?? readPackageVersion(import.meta.url)
+    },
+    env: {
+      dataDir: {
+        primary: "HASNA_MCPS_DATA_DIR",
+        fallback: "MCPS_DATA_DIR",
+        active: activeDataDirEnv()
+      },
+      database: {
+        primary: "HASNA_MCPS_DB_PATH",
+        fallback: "MCPS_DB_PATH",
+        active: activeDatabaseEnv()
+      },
+      credentialVaultConfigured: Boolean(process.env["HASNA_MCPS_CREDENTIAL_VAULT_PATH"])
+    },
+    registry: {
+      sources: {
+        total: input.sources.length,
+        enabled: enabledSources,
+        disabled: input.sources.length - enabledSources,
+        byType: countBy(input.sources, (source) => source.type)
+      },
+      providerProfiles: {
+        total: input.providerProfiles.length,
+        enabled: enabledProfiles,
+        disabled: input.providerProfiles.length - enabledProfiles
+      }
+    },
+    cache: {
+      directoryPresent: input.cacheDirectoryPresent,
+      cachedTools,
+      serversWithCachedTools: [...input.toolCounts.values()].filter((count) => count > 0).length
+    },
+    counts: {
+      servers: {
+        total: input.servers.length,
+        enabled: enabledServers,
+        disabled: input.servers.length - enabledServers,
+        byTransport: countBy(input.servers, (server) => server.transport),
+        bySource: countBy(input.servers, (server) => server.source),
+        withLastError: serversWithLastError
+      },
+      machines: {
+        total: input.machines.length,
+        enabled: enabledMachines,
+        disabled: input.machines.length - enabledMachines
+      }
+    },
+    health: {
+      status,
+      databaseReachable,
+      hasRegisteredServers: input.servers.length > 0,
+      hasServerErrors: serversWithLastError > 0
+    },
+    safety: {
+      includesToolConfigs: false,
+      includesCommands: false,
+      includesArgs: false,
+      includesEnvValues: false,
+      includesCredentialRefs: false,
+      includesTokens: false,
+      includesPrivatePaths: false,
+      includesRegistryUrls: false,
+      statusOutputIsMetadataOnly: true
+    }
+  };
+}
+function getMcpsStatus() {
+  try {
+    return buildMcpsStatus({
+      servers: listServers(),
+      sources: listSources(),
+      providerProfiles: listProviderProfiles(),
+      machines: listMachines(),
+      toolCounts: getToolCounts(),
+      cacheDirectoryPresent: existsSync12(join13(MCPS_DIR, "cache"))
+    });
+  } catch {
+    return buildMcpsStatus({
+      servers: [],
+      sources: [],
+      providerProfiles: [],
+      machines: [],
+      toolCounts: new Map,
+      cacheDirectoryPresent: false,
+      databaseReachable: false
+    });
+  }
+}
 
 // src/index.ts
 init_db();
@@ -27660,6 +27792,7 @@ export {
   getServer,
   getRegistryServer,
   getProviderProfile,
+  getMcpsStatus,
   getMachine,
   getDb,
   getCachedTools,
@@ -27679,6 +27812,7 @@ export {
   closeDb,
   cloneServer,
   callTool,
+  buildMcpsStatus,
   assertLocalCommandConsent,
   addSource,
   addServer,

package/dist/lib/status.d.ts

@@ -0,0 +1,89 @@
+import type { McpServerEntry, McpSource, ProviderProfile } from "../types.js";
+type ActiveDataDirEnv = "HASNA_MCPS_DATA_DIR" | "MCPS_DATA_DIR" | null;
+type ActiveDbEnv = "HASNA_MCPS_DB_PATH" | "MCPS_DB_PATH" | null;
+type ContractStatus = "ok" | "warn";
+export interface McpsStatusContract {
+    service: "mcps";
+    schemaVersion: "1.0";
+    package: {
+        name: "@hasna/mcps";
+        version: string;
+    };
+    env: {
+        dataDir: {
+            primary: "HASNA_MCPS_DATA_DIR";
+            fallback: "MCPS_DATA_DIR";
+            active: ActiveDataDirEnv;
+        };
+        database: {
+            primary: "HASNA_MCPS_DB_PATH";
+            fallback: "MCPS_DB_PATH";
+            active: ActiveDbEnv;
+        };
+        credentialVaultConfigured: boolean;
+    };
+    registry: {
+        sources: {
+            total: number;
+            enabled: number;
+            disabled: number;
+            byType: Record<string, number>;
+        };
+        providerProfiles: {
+            total: number;
+            enabled: number;
+            disabled: number;
+        };
+    };
+    cache: {
+        directoryPresent: boolean;
+        cachedTools: number;
+        serversWithCachedTools: number;
+    };
+    counts: {
+        servers: {
+            total: number;
+            enabled: number;
+            disabled: number;
+            byTransport: Record<string, number>;
+            bySource: Record<string, number>;
+            withLastError: number;
+        };
+        machines: {
+            total: number;
+            enabled: number;
+            disabled: number;
+        };
+    };
+    health: {
+        status: ContractStatus;
+        databaseReachable: boolean;
+        hasRegisteredServers: boolean;
+        hasServerErrors: boolean;
+    };
+    safety: {
+        includesToolConfigs: false;
+        includesCommands: false;
+        includesArgs: false;
+        includesEnvValues: false;
+        includesCredentialRefs: false;
+        includesTokens: false;
+        includesPrivatePaths: false;
+        includesRegistryUrls: false;
+        statusOutputIsMetadataOnly: true;
+    };
+}
+export declare function buildMcpsStatus(input: {
+    servers: McpServerEntry[];
+    sources: McpSource[];
+    providerProfiles: ProviderProfile[];
+    machines: Array<{
+        enabled: boolean;
+    }>;
+    toolCounts: Map<string, number>;
+    cacheDirectoryPresent: boolean;
+    databaseReachable?: boolean;
+    packageVersion?: string;
+}): McpsStatusContract;
+export declare function getMcpsStatus(): McpsStatusContract;
+export {};

package/dist/mcp/index.js

@@ -34898,30 +34898,30 @@ var init_machines = __esm(() => {
   init_db();
   DEFAULT_MACHINE_SEEDS = [
     {
-      id: "spark01",
-      name: "spark01",
-      host: "spark01",
+      id: "linux-node-a",
+      name: "linux-node-a",
+      host: "linux-node-a",
       platform: "linux",
       arch: "arm64"
     },
     {
-      id: "spark02",
-      name: "spark02",
-      host: "spark02",
+      id: "linux-node-b",
+      name: "linux-node-b",
+      host: "linux-node-b",
       platform: "linux",
       arch: "arm64"
     },
     {
-      id: "apple01",
-      name: "apple01",
-      host: "apple01",
+      id: "macos-node-a",
+      name: "macos-node-a",
+      host: "macos-node-a",
       platform: "darwin",
       arch: "arm64"
     },
     {
-      id: "apple03",
-      name: "apple03",
-      host: "apple03",
+      id: "macos-node-b",
+      name: "macos-node-b",
+      host: "macos-node-b",
       platform: "darwin",
       arch: "arm64"
     }
@@ -37682,8 +37682,12 @@ function isStdioMode(args = process.argv.slice(2)) {
 function resolveHttpPort(args = process.argv.slice(2)) {
   for (let i = 0;i < args.length; i++) {
     const arg = args[i];
-    if (arg === "--port" && args[i + 1]) {
-      return parsePort(args[i + 1]);
+    if (arg === "--port") {
+      const value = args[i + 1];
+      if (value === undefined || value === "" || value.startsWith("--")) {
+        throw new Error("Missing value for --port");
+      }
+      return parsePort(value);
     }
     if (arg.startsWith("--port=")) {
       return parsePort(arg.slice("--port=".length));
@@ -37696,7 +37700,11 @@ function resolveHttpPort(args = process.argv.slice(2)) {
   return DEFAULT_HTTP_PORT;
 }
 function parsePort(raw) {
-  const port = Number.parseInt(raw, 10);
+  const normalized = raw.trim();
+  if (!/^\d+$/.test(normalized)) {
+    throw new Error(`Invalid port: ${raw}`);
+  }
+  const port = Number(normalized);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw new Error(`Invalid port: ${raw}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mcps",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "Meta-MCP registry & CLI — discover, manage, and proxy MCP servers",
   "type": "module",
   "repository": {