@mcp-z/client 1.0.0

package/dist/esm/utils/path-utils.js

@@ -0,0 +1,89 @@
+/**
+ * Path resolution utilities for cluster spawning.
+ * Handles ~, relative paths, absolute paths, and special cases (URLs, npm packages, flags).
+ */ import * as os from 'os';
+import * as path from 'path';
+/**
+ * Resolve a file path relative to a working directory.
+ *
+ * Handles three cases:
+ * - `~` or `~/path` - Expands to home directory
+ * - Absolute paths - Returns as-is
+ * - Relative paths - Resolves relative to cwd
+ *
+ * @param filePath - The path to resolve
+ * @param cwd - The working directory for resolving relative paths
+ * @returns The resolved absolute path
+ *
+ * @example
+ * resolvePath('~/config.json', '/unused')  // → '/home/user/config.json'
+ * resolvePath('/absolute/path', '/unused') // → '/absolute/path'
+ * resolvePath('./relative', '/base')       // → '/base/relative'
+ */ export function resolvePath(filePath, cwd) {
+    // Expand ~ to home directory
+    if (filePath === '~' || filePath.startsWith('~/')) {
+        filePath = filePath.replace(/^~/, os.homedir());
+    }
+    // If absolute, return as-is
+    if (path.isAbsolute(filePath)) {
+        return filePath;
+    }
+    // Otherwise resolve relative to cwd
+    return path.resolve(cwd, filePath);
+}
+/**
+ * Resolve paths in command arguments array.
+ *
+ * Intelligently handles different argument types:
+ * - Flags with paths: `--env-file=./path` → `--env-file=/absolute/path`
+ * - Flags without paths: `--port=3000` → unchanged
+ * - Command flags: `--verbose` → unchanged
+ * - URLs: `http://example.com` → unchanged
+ * - npm packages: `@scope/package` or `package-name` → unchanged
+ * - Regular paths: `./script.js` → `/absolute/script.js`
+ *
+ * @param args - Array of command arguments
+ * @param cwd - Working directory for resolving relative paths
+ * @returns Array with paths resolved
+ *
+ * @example
+ * resolveArgsPaths(['./bin/server.js', '--env-file=./config.env', '--port=3000'], '/home/user')
+ * // → ['/home/user/bin/server.js', '--env-file=/home/user/config.env', '--port=3000']
+ *
+ * resolveArgsPaths(['@scope/package', 'https://example.com'], '/unused')
+ * // → ['@scope/package', 'https://example.com'] (unchanged)
+ */ export function resolveArgsPaths(args, cwd) {
+    return args.map((arg)=>{
+        if (typeof arg !== 'string') {
+            return arg;
+        }
+        // Check for flags with path values like --env-file=path, --config=path, etc.
+        const flagMatch = arg.match(/^(--.+?)=(.+)$/);
+        if (flagMatch) {
+            const [, flag, value] = flagMatch;
+            // Only resolve if the value looks like a path (contains ./ or ../ or / )
+            if (value && value.includes('/')) {
+                // Skip URLs in flag values
+                if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(value)) {
+                    return arg;
+                }
+                return `${flag}=${resolvePath(value, cwd)}`;
+            }
+            return arg; // Return as-is for non-path flag values like --port=3000
+        }
+        // Skip command-line flags, only resolve actual paths
+        if (arg.startsWith('-')) {
+            return arg; // Don't resolve command-line flags as paths
+        }
+        // Skip URLs (http://, https://, etc.)
+        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(arg)) {
+            return arg; // Return URLs as-is
+        }
+        // Skip npm package names (starting with @ or containing no path separators)
+        if (arg.startsWith('@') || !arg.includes('/') && !arg.includes('\\')) {
+            return arg; // Return npm package names as-is
+        }
+        // Regular arguments get resolved as paths
+        return resolvePath(arg, cwd);
+    });
+}

package/dist/esm/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/utils/path-utils.ts"],"sourcesContent":["/**\n * Path resolution utilities for cluster spawning.\n * Handles ~, relative paths, absolute paths, and special cases (URLs, npm packages, flags).\n */\n\nimport * as os from 'os';\nimport * as path from 'path';\n\n/**\n * Resolve a file path relative to a working directory.\n *\n * Handles three cases:\n * - `~` or `~/path` - Expands to home directory\n * - Absolute paths - Returns as-is\n * - Relative paths - Resolves relative to cwd\n *\n * @param filePath - The path to resolve\n * @param cwd - The working directory for resolving relative paths\n * @returns The resolved absolute path\n *\n * @example\n * resolvePath('~/config.json', '/unused')  // → '/home/user/config.json'\n * resolvePath('/absolute/path', '/unused') // → '/absolute/path'\n * resolvePath('./relative', '/base')       // → '/base/relative'\n */\nexport function resolvePath(filePath: string, cwd: string): string {\n  // Expand ~ to home directory\n  if (filePath === '~' || filePath.startsWith('~/')) {\n    filePath = filePath.replace(/^~/, os.homedir());\n  }\n\n  // If absolute, return as-is\n  if (path.isAbsolute(filePath)) {\n    return filePath;\n  }\n\n  // Otherwise resolve relative to cwd\n  return path.resolve(cwd, filePath);\n}\n\n/**\n * Resolve paths in command arguments array.\n *\n * Intelligently handles different argument types:\n * - Flags with paths: `--env-file=./path` → `--env-file=/absolute/path`\n * - Flags without paths: `--port=3000` → unchanged\n * - Command flags: `--verbose` → unchanged\n * - URLs: `http://example.com` → unchanged\n * - npm packages: `@scope/package` or `package-name` → unchanged\n * - Regular paths: `./script.js` → `/absolute/script.js`\n *\n * @param args - Array of command arguments\n * @param cwd - Working directory for resolving relative paths\n * @returns Array with paths resolved\n *\n * @example\n * resolveArgsPaths(['./bin/server.js', '--env-file=./config.env', '--port=3000'], '/home/user')\n * // → ['/home/user/bin/server.js', '--env-file=/home/user/config.env', '--port=3000']\n *\n * resolveArgsPaths(['@scope/package', 'https://example.com'], '/unused')\n * // → ['@scope/package', 'https://example.com'] (unchanged)\n */\nexport function resolveArgsPaths(args: string[], cwd: string): string[] {\n  return args.map((arg) => {\n    if (typeof arg !== 'string') {\n      return arg;\n    }\n\n    // Check for flags with path values like --env-file=path, --config=path, etc.\n    const flagMatch = arg.match(/^(--.+?)=(.+)$/);\n    if (flagMatch) {\n      const [, flag, value] = flagMatch;\n      // Only resolve if the value looks like a path (contains ./ or ../ or / )\n      if (value && value.includes('/')) {\n        // Skip URLs in flag values\n        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\\/\\//.test(value)) {\n          return arg;\n        }\n        return `${flag}=${resolvePath(value, cwd)}`;\n      }\n      return arg; // Return as-is for non-path flag values like --port=3000\n    }\n\n    // Skip command-line flags, only resolve actual paths\n    if (arg.startsWith('-')) {\n      return arg; // Don't resolve command-line flags as paths\n    }\n\n    // Skip URLs (http://, https://, etc.)\n    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\\/\\//.test(arg)) {\n      return arg; // Return URLs as-is\n    }\n\n    // Skip npm package names (starting with @ or containing no path separators)\n    if (arg.startsWith('@') || (!arg.includes('/') && !arg.includes('\\\\'))) {\n      return arg; // Return npm package names as-is\n    }\n\n    // Regular arguments get resolved as paths\n    return resolvePath(arg, cwd);\n  });\n}\n"],"names":["os","path","resolvePath","filePath","cwd","startsWith","replace","homedir","isAbsolute","resolve","resolveArgsPaths","args","map","arg","flagMatch","match","flag","value","includes","test"],"mappings":"AAAA;;;CAGC,GAED,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAE7B;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASC,YAAYC,QAAgB,EAAEC,GAAW;IACvD,6BAA6B;IAC7B,IAAID,aAAa,OAAOA,SAASE,UAAU,CAAC,OAAO;QACjDF,WAAWA,SAASG,OAAO,CAAC,MAAMN,GAAGO,OAAO;IAC9C;IAEA,4BAA4B;IAC5B,IAAIN,KAAKO,UAAU,CAACL,WAAW;QAC7B,OAAOA;IACT;IAEA,oCAAoC;IACpC,OAAOF,KAAKQ,OAAO,CAACL,KAAKD;AAC3B;AAEA;;;;;;;;;;;;;;;;;;;;;CAqBC,GACD,OAAO,SAASO,iBAAiBC,IAAc,EAAEP,GAAW;IAC1D,OAAOO,KAAKC,GAAG,CAAC,CAACC;QACf,IAAI,OAAOA,QAAQ,UAAU;YAC3B,OAAOA;QACT;QAEA,6EAA6E;QAC7E,MAAMC,YAAYD,IAAIE,KAAK,CAAC;QAC5B,IAAID,WAAW;YACb,MAAM,GAAGE,MAAMC,MAAM,GAAGH;YACxB,yEAAyE;YACzE,IAAIG,SAASA,MAAMC,QAAQ,CAAC,MAAM;gBAChC,2BAA2B;gBAC3B,IAAI,gCAAgCC,IAAI,CAACF,QAAQ;oBAC/C,OAAOJ;gBACT;gBACA,OAAO,GAAGG,KAAK,CAAC,EAAEd,YAAYe,OAAOb,MAAM;YAC7C;YACA,OAAOS,KAAK,yDAAyD;QACvE;QAEA,qDAAqD;QACrD,IAAIA,IAAIR,UAAU,CAAC,MAAM;YACvB,OAAOQ,KAAK,4CAA4C;QAC1D;QAEA,sCAAsC;QACtC,IAAI,gCAAgCM,IAAI,CAACN,MAAM;YAC7C,OAAOA,KAAK,oBAAoB;QAClC;QAEA,4EAA4E;QAC5E,IAAIA,IAAIR,UAAU,CAAC,QAAS,CAACQ,IAAIK,QAAQ,CAAC,QAAQ,CAACL,IAAIK,QAAQ,CAAC,OAAQ;YACtE,OAAOL,KAAK,iCAAiC;QAC/C;QAEA,0CAA0C;QAC1C,OAAOX,YAAYW,KAAKT;IAC1B;AACF"}

package/dist/esm/utils/sanitizer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Minimal log sanitization for spawn operations
+ * Redacts credentials from environment variables and command arguments
+ */
+import type { SpawnMetadata } from '../connection/types.js';
+/**
+ * Sanitize log messages and metadata to prevent credential leakage
+ *
+ * Redacts common credential patterns:
+ * - key=value, secret=value, token=value, password=value
+ * - Environment variables with sensitive names
+ *
+ * @param message - Log message to sanitize
+ * @param obj - Metadata object to sanitize
+ * @returns Sanitized message and metadata
+ */
+export declare function sanitizeForLogging(message: string, obj: SpawnMetadata): {
+    message: string;
+    meta: SpawnMetadata;
+};
+export declare function sanitizeForLoggingFormatter(): {
+    log: (obj: SpawnMetadata) => {
+        msg: string;
+        command?: string;
+        args?: string[];
+        env?: Record<string, string>;
+        cwd?: string;
+        pid?: number;
+    };
+};

package/dist/esm/utils/sanitizer.js

@@ -0,0 +1,43 @@
+/**
+ * Minimal log sanitization for spawn operations
+ * Redacts credentials from environment variables and command arguments
+ */ /**
+ * Sanitize log messages and metadata to prevent credential leakage
+ *
+ * Redacts common credential patterns:
+ * - key=value, secret=value, token=value, password=value
+ * - Environment variables with sensitive names
+ *
+ * @param message - Log message to sanitize
+ * @param obj - Metadata object to sanitize
+ * @returns Sanitized message and metadata
+ */ export function sanitizeForLogging(message, obj) {
+    // Redact common credential patterns in message
+    const cleanMessage = message.replace(/key[=:]\S+/gi, 'key=[REDACTED]').replace(/secret[=:]\S+/gi, 'secret=[REDACTED]').replace(/token[=:]\S+/gi, 'token=[REDACTED]').replace(/password[=:]\S+/gi, 'password=[REDACTED]').replace(/auth[=:]\S+/gi, 'auth=[REDACTED]');
+    // Deep clone and redact sensitive env var keys
+    const cleanMeta = JSON.parse(JSON.stringify(obj));
+    // Redact sensitive environment variable values
+    if (cleanMeta.env && typeof cleanMeta.env === 'object') {
+        for (const envKey of Object.keys(cleanMeta.env)){
+            if (/key|secret|token|password|auth|credential/i.test(envKey)) {
+                cleanMeta.env[envKey] = '[REDACTED]';
+            }
+        }
+    }
+    return {
+        message: cleanMessage,
+        meta: cleanMeta
+    };
+}
+export function sanitizeForLoggingFormatter() {
+    return {
+        log: (obj)=>{
+            const message = obj.msg || obj.message || '';
+            const { message: clean, meta } = sanitizeForLogging(message, obj);
+            return {
+                ...meta,
+                msg: clean
+            };
+        }
+    };
+}

package/dist/esm/utils/sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/utils/sanitizer.ts"],"sourcesContent":["/**\n * Minimal log sanitization for spawn operations\n * Redacts credentials from environment variables and command arguments\n */\n\nimport type { SpawnMetadata } from '../connection/types.ts';\n\n/**\n * Sanitize log messages and metadata to prevent credential leakage\n *\n * Redacts common credential patterns:\n * - key=value, secret=value, token=value, password=value\n * - Environment variables with sensitive names\n *\n * @param message - Log message to sanitize\n * @param obj - Metadata object to sanitize\n * @returns Sanitized message and metadata\n */\nexport function sanitizeForLogging(message: string, obj: SpawnMetadata): { message: string; meta: SpawnMetadata } {\n  // Redact common credential patterns in message\n  const cleanMessage = message\n    .replace(/key[=:]\\S+/gi, 'key=[REDACTED]')\n    .replace(/secret[=:]\\S+/gi, 'secret=[REDACTED]')\n    .replace(/token[=:]\\S+/gi, 'token=[REDACTED]')\n    .replace(/password[=:]\\S+/gi, 'password=[REDACTED]')\n    .replace(/auth[=:]\\S+/gi, 'auth=[REDACTED]');\n\n  // Deep clone and redact sensitive env var keys\n  const cleanMeta = JSON.parse(JSON.stringify(obj));\n\n  // Redact sensitive environment variable values\n  if (cleanMeta.env && typeof cleanMeta.env === 'object') {\n    for (const envKey of Object.keys(cleanMeta.env)) {\n      if (/key|secret|token|password|auth|credential/i.test(envKey)) {\n        cleanMeta.env[envKey] = '[REDACTED]';\n      }\n    }\n  }\n\n  return { message: cleanMessage, meta: cleanMeta };\n}\n\nexport function sanitizeForLoggingFormatter() {\n  return {\n    log: (obj: SpawnMetadata) => {\n      const message = (obj.msg || obj.message || '') as string;\n      const { message: clean, meta } = sanitizeForLogging(message, obj);\n      return { ...meta, msg: clean };\n    },\n  };\n}\n"],"names":["sanitizeForLogging","message","obj","cleanMessage","replace","cleanMeta","JSON","parse","stringify","env","envKey","Object","keys","test","meta","sanitizeForLoggingFormatter","log","msg","clean"],"mappings":"AAAA;;;CAGC,GAID;;;;;;;;;;CAUC,GACD,OAAO,SAASA,mBAAmBC,OAAe,EAAEC,GAAkB;IACpE,+CAA+C;IAC/C,MAAMC,eAAeF,QAClBG,OAAO,CAAC,gBAAgB,kBACxBA,OAAO,CAAC,mBAAmB,qBAC3BA,OAAO,CAAC,kBAAkB,oBAC1BA,OAAO,CAAC,qBAAqB,uBAC7BA,OAAO,CAAC,iBAAiB;IAE5B,+CAA+C;IAC/C,MAAMC,YAAYC,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACN;IAE5C,+CAA+C;IAC/C,IAAIG,UAAUI,GAAG,IAAI,OAAOJ,UAAUI,GAAG,KAAK,UAAU;QACtD,KAAK,MAAMC,UAAUC,OAAOC,IAAI,CAACP,UAAUI,GAAG,EAAG;YAC/C,IAAI,6CAA6CI,IAAI,CAACH,SAAS;gBAC7DL,UAAUI,GAAG,CAACC,OAAO,GAAG;YAC1B;QACF;IACF;IAEA,OAAO;QAAET,SAASE;QAAcW,MAAMT;IAAU;AAClD;AAEA,OAAO,SAASU;IACd,OAAO;QACLC,KAAK,CAACd;YACJ,MAAMD,UAAWC,IAAIe,GAAG,IAAIf,IAAID,OAAO,IAAI;YAC3C,MAAM,EAAEA,SAASiB,KAAK,EAAEJ,IAAI,EAAE,GAAGd,mBAAmBC,SAASC;YAC7D,OAAO;gBAAE,GAAGY,IAAI;gBAAEG,KAAKC;YAAM;QAC/B;IACF;AACF"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@mcp-z/client",
+  "version": "1.0.0",
+  "description": "Programmatic MCP client library for Node.js - connect, discover, and call tools on Model Context Protocol servers.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "mcp-client",
+    "server",
+    "client",
+    "lib",
+    "token-storage",
+    "testing",
+    "integration-testing",
+    "development-tools",
+    "server-management",
+    "lifecycle",
+    "graceful-shutdown",
+    "test-utilities",
+    "workflow",
+    "ai",
+    "claude"
+  ],
+  "homepage": "https://github.com/mcp-z/cli#readme",
+  "bugs": {
+    "url": "https://github.com/mcp-z/cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcp-z/cli.git"
+  },
+  "license": "MIT",
+  "author": "Kevin Malakoff <kmalakoff.info@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "files": [
+    "dist",
+    "schemas",
+    "AGENTS.md"
+  ],
+  "scripts": {
+    "build": "tsc -p . --noEmit && tsds build",
+    "format": "tsds format",
+    "generate:types": "json2ts schemas/servers.schema.json schemas/servers.d.ts --bannerComment \"/* eslint-disable */\n/* Auto-generated from schemas/servers.schema.json - DO NOT EDIT */\"",
+    "prepublish:check": "ncp",
+    "prepublishOnly": "tsds validate",
+    "test": "npm run test:unit && npm run test:integration",
+    "test:engines": "nvu engines tsds test:node --no-timeouts",
+    "test:integration": "tsds test:node --no-timeouts 'test/integration/**/*.test.ts'",
+    "test:unit": "tsds test:node --no-timeouts 'test/unit/**/*.test.ts'",
+    "version": "tsds version"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "get-port": "^7.1.0",
+    "keyv": "^5.5.5",
+    "keyv-file": "^5.3.3",
+    "module-root-sync": "^2.0.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^25.0.2",
+    "dotenv": "^17.2.3",
+    "express": "^5.0.0",
+    "json-schema-to-typescript": "^15.0.4",
+    "node-version-use": "^2.1.6",
+    "ts-dev-stack": "^1.21.3",
+    "tsds-config": "^1.0.0",
+    "typescript": "^5.9.3",
+    "zod": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "tsds": {
+    "source": "src/index.ts"
+  }
+}

package/schemas/servers.d.ts

@@ -0,0 +1,90 @@
+/* eslint-disable */
+/* Auto-generated from schemas/servers.schema.json - DO NOT EDIT */
+
+/**
+ * Map of server names to their configurations. Compatible with Claude Code mcpServers and VS Code servers formats.
+ */
+export interface MCPServers {
+  [k: string]: McpServerEntry;
+}
+/**
+ * Configuration for a single MCP server. Transport type is determined by the 'type' field (defaults to 'stdio').
+ */
+export interface McpServerEntry {
+  /**
+   * Transport type. Defaults to 'stdio' if omitted.
+   */
+  type?: 'stdio' | 'http' | 'sse-ide' | 'ws-ide' | 'sdk';
+  /**
+   * Command to execute (stdio transport)
+   */
+  command?: string;
+  /**
+   * Command arguments (stdio transport)
+   */
+  args?: string[];
+  /**
+   * Environment variables
+   */
+  env?: {
+    [k: string]: string;
+  };
+  /**
+   * Working directory
+   */
+  cwd?: string;
+  /**
+   * Server URL (http, sse-ide, ws-ide transports)
+   */
+  url?: string;
+  /**
+   * HTTP headers (http transport)
+   */
+  headers?: {
+    [k: string]: string;
+  };
+  /**
+   * Helper command for dynamic header generation (http transport)
+   */
+  headersHelper?: string;
+  /**
+   * IDE identifier (sse-ide, ws-ide transports)
+   */
+  ideName?: string;
+  /**
+   * Authentication token (ws-ide transport)
+   */
+  authToken?: string;
+  /**
+   * Whether IDE is running on Windows (sse-ide, ws-ide transports)
+   */
+  ideRunningInWindows?: boolean;
+  /**
+   * SDK name identifier (sdk transport)
+   */
+  name?: string;
+  start?: StartConfig;
+}
+/**
+ * MCP-Z extension: Auto-start configuration for HTTP servers
+ */
+export interface StartConfig {
+  /**
+   * Command to start the server
+   */
+  command: string;
+  /**
+   * Command arguments
+   */
+  args?: string[];
+  /**
+   * Environment variables
+   */
+  env?: {
+    [k: string]: string;
+  };
+  /**
+   * Working directory
+   */
+  cwd?: string;
+}

package/schemas/servers.schema.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mcpeasy.dev/schemas/servers.schema.json",
+  "title": "MCP Servers",
+  "description": "Map of server names to their configurations. Compatible with Claude Code mcpServers and VS Code servers formats.",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/definitions/McpServerEntry"
+  },
+  "definitions": {
+    "McpServerEntry": {
+      "type": "object",
+      "description": "Configuration for a single MCP server. Transport type is determined by the 'type' field (defaults to 'stdio').",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["stdio", "http", "sse-ide", "ws-ide", "sdk"],
+          "description": "Transport type. Defaults to 'stdio' if omitted."
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Command to execute (stdio transport)"
+        },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Command arguments (stdio transport)"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Environment variables"
+        },
+        "cwd": {
+          "type": "string",
+          "description": "Working directory"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Server URL (http, sse-ide, ws-ide transports)"
+        },
+        "headers": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "HTTP headers (http transport)"
+        },
+        "headersHelper": {
+          "type": "string",
+          "description": "Helper command for dynamic header generation (http transport)"
+        },
+        "ideName": {
+          "type": "string",
+          "description": "IDE identifier (sse-ide, ws-ide transports)"
+        },
+        "authToken": {
+          "type": "string",
+          "description": "Authentication token (ws-ide transport)"
+        },
+        "ideRunningInWindows": {
+          "type": "boolean",
+          "description": "Whether IDE is running on Windows (sse-ide, ws-ide transports)"
+        },
+        "name": {
+          "type": "string",
+          "description": "SDK name identifier (sdk transport)"
+        },
+        "start": {
+          "$ref": "#/definitions/StartConfig",
+          "description": "MCP-Z extension: Auto-start configuration for HTTP servers"
+        }
+      },
+      "additionalProperties": false
+    },
+    "StartConfig": {
+      "type": "object",
+      "description": "MCP-Z extension: Configuration for auto-starting HTTP servers",
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Command to start the server"
+        },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Command arguments"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Environment variables"
+        },
+        "cwd": {
+          "type": "string",
+          "description": "Working directory"
+        }
+      },
+      "required": ["command"],
+      "additionalProperties": false
+    }
+  }
+}