@openziti/ziti-mcp-server 0.1.0

package/dist/clients/claude.js

@@ -0,0 +1,40 @@
+import * as path from 'path';
+import * as os from 'os';
+import { BaseClientManager } from './base.js';
+import { getPlatformPath, ensureDir } from './utils.js';
+/**
+ * Client manager implementation for Claude Desktop.
+ *
+ * Responsible for configuring and managing the MCP server integration
+ * for the Claude Desktop application.
+ *
+ * @see {@link https://claude.ai/download | Claude Desktop Download}
+ */
+export class ClaudeClientManager extends BaseClientManager {
+    constructor() {
+        super({
+            clientType: 'claude',
+            displayName: 'Claude Desktop',
+            capabilities: ['tools'],
+        });
+    }
+    /**
+     * Returns the path to the Claude Desktop configuration file.
+     *
+     * Resolves the platform-specific configuration directory,
+     * ensures the directory exists on disk, and constructs the full path
+     * to the Claude Desktop configuration file.
+     *
+     * @returns The absolute path to the configuration file.
+     */
+    getConfigPath() {
+        const configDir = getPlatformPath({
+            darwin: path.join(os.homedir(), 'Library', 'Application Support', 'Claude'),
+            win32: path.join('{APPDATA}', 'Claude'), // assumes getPlatformPath resolves {APPDATA}
+            linux: path.join(os.homedir(), '.config', 'Claude'),
+        });
+        ensureDir(configDir);
+        return path.join(configDir, 'claude_desktop_config.json');
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/clients/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/clients/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD;QACE,KAAK,CAAC;YACJ,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,gBAAgB;YAC7B,YAAY,EAAE,CAAC,OAAO,CAAC;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa;QACX,MAAM,SAAS,GAAG,eAAe,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,CAAC;YAC3E,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,6CAA6C;YACtF,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC;SACpD,CAAC,CAAC;QAEH,SAAS,CAAC,SAAS,CAAC,CAAC;QAErB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/clients/cursor.d.ts

@@ -0,0 +1,22 @@
+import { BaseClientManager } from './base.js';
+/**
+ * Client manager implementation for Cursor.
+ *
+ * Responsible for configuring and managing the MCP server integration
+ * for the Cursor code editor application.
+ *
+ * @see {@link https://www.cursor.com/ | Cursor Official Website}
+ */
+export declare class CursorClientManager extends BaseClientManager {
+    constructor();
+    /**
+     * Returns the path to the Cursor configuration file.
+     *
+     * Resolves the platform-specific configuration directory,
+     * ensures the directory exists on disk, and constructs the full path
+     * to the MCP configuration file.
+     *
+     * @returns The absolute path to the configuration file.
+     */
+    getConfigPath(): string;
+}

package/dist/clients/cursor.js

@@ -0,0 +1,39 @@
+import * as path from 'path';
+import * as os from 'os';
+import { BaseClientManager } from './base.js';
+import { getPlatformPath, ensureDir } from './utils.js';
+/**
+ * Client manager implementation for Cursor.
+ *
+ * Responsible for configuring and managing the MCP server integration
+ * for the Cursor code editor application.
+ *
+ * @see {@link https://www.cursor.com/ | Cursor Official Website}
+ */
+export class CursorClientManager extends BaseClientManager {
+    constructor() {
+        super({
+            clientType: 'cursor',
+            displayName: 'Cursor',
+        });
+    }
+    /**
+     * Returns the path to the Cursor configuration file.
+     *
+     * Resolves the platform-specific configuration directory,
+     * ensures the directory exists on disk, and constructs the full path
+     * to the MCP configuration file.
+     *
+     * @returns The absolute path to the configuration file.
+     */
+    getConfigPath() {
+        const configDir = getPlatformPath({
+            darwin: path.join(os.homedir(), '.cursor'),
+            win32: path.join('{APPDATA}', '.cursor'),
+            linux: path.join(os.homedir(), '.cursor'),
+        });
+        ensureDir(configDir);
+        return path.join(configDir, 'mcp.json');
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/clients/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/clients/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD;QACE,KAAK,CAAC;YACJ,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,QAAQ;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa;QACX,MAAM,SAAS,GAAG,eAAe,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC;YAC1C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;YACxC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC;SAC1C,CAAC,CAAC;QAEH,SAAS,CAAC,SAAS,CAAC,CAAC;QAErB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/clients/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MCP client exports for configuration management.
+ *
+ * Provides initialized client manager instances for supported applications.
+ *
+ * @module clients
+ */
+import { ClaudeClientManager } from './claude.js';
+import { CursorClientManager } from './cursor.js';
+import { WindsurfClientManager } from './windsurf.js';
+import { VSCodeClientManager } from './vscode.js';
+/**
+ * Namespace object containing initialized client managers.
+ *
+ * Each property corresponds to a supported client application.
+ *
+ * @property {ClaudeClientManager} claude - Manager for Claude Desktop.
+ * @property {CursorClientManager} cursor - Manager for Cursor code editor.
+ * @property {WindsurfClientManager} windsurf - Manager for Windsurf editor.
+ * @property {VSCodeClientManager} vscode - Manager for Visual Studio Code.
+ *
+ * @see {@link https://claude.ai/download | Claude Desktop}
+ * @see {@link https://www.cursor.com/ | Cursor Code Editor}
+ * @see {@link https://windsurf.com/editor | Windsurf Editor}
+ * @see {@link https://code.visualstudio.com/ | Visual Studio Code}
+ */
+export declare const clients: {
+    claude: ClaudeClientManager;
+    cursor: CursorClientManager;
+    windsurf: WindsurfClientManager;
+    vscode: VSCodeClientManager;
+};
+export type { ClientType, ClientManager, ClientConfig, ServerConfig } from './types.js';

package/dist/clients/index.js

@@ -0,0 +1,39 @@
+/**
+ * MCP client exports for configuration management.
+ *
+ * Provides initialized client manager instances for supported applications.
+ *
+ * @module clients
+ */
+// Import client classes
+import { ClaudeClientManager } from './claude.js';
+import { CursorClientManager } from './cursor.js';
+import { WindsurfClientManager } from './windsurf.js';
+import { VSCodeClientManager } from './vscode.js';
+// Create client manager instances
+const claude = new ClaudeClientManager();
+const cursor = new CursorClientManager();
+const windsurf = new WindsurfClientManager();
+const vscode = new VSCodeClientManager();
+/**
+ * Namespace object containing initialized client managers.
+ *
+ * Each property corresponds to a supported client application.
+ *
+ * @property {ClaudeClientManager} claude - Manager for Claude Desktop.
+ * @property {CursorClientManager} cursor - Manager for Cursor code editor.
+ * @property {WindsurfClientManager} windsurf - Manager for Windsurf editor.
+ * @property {VSCodeClientManager} vscode - Manager for Visual Studio Code.
+ *
+ * @see {@link https://claude.ai/download | Claude Desktop}
+ * @see {@link https://www.cursor.com/ | Cursor Code Editor}
+ * @see {@link https://windsurf.com/editor | Windsurf Editor}
+ * @see {@link https://code.visualstudio.com/ | Visual Studio Code}
+ */
+export const clients = {
+    claude,
+    cursor,
+    windsurf,
+    vscode,
+};
+//# sourceMappingURL=index.js.map

package/dist/clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,kCAAkC;AAClC,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;AACzC,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;AACzC,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;AAC7C,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM;IACN,MAAM;IACN,QAAQ;IACR,MAAM;CACP,CAAC"}

package/dist/clients/types.d.ts

@@ -0,0 +1,70 @@
+import type { ClientOptions } from '../utils/types.js';
+/**
+ * Supported client types.
+ *
+ * Represents the set of known MCP client applications supported by this project.
+ */
+export type ClientType = 'claude' | 'cursor' | 'windsurf' | 'vscode';
+/**
+ * MCP server configuration object used in client configuration files.
+ *
+ * Defines the parameters needed to launch the MCP server in the context of a client application.
+ */
+export interface ServerConfig {
+    /** Command-line arguments to pass when launching the MCP server. */
+    args: string[];
+    /** Base command to execute (typically 'npx' or similar). */
+    command: string;
+    /** Optional environment variables to set when executing the command. */
+    env?: Record<string, string>;
+    /** Optional list of capabilities supported by the client integration. */
+    capabilities?: string[];
+}
+/**
+ * Generic client configuration format shared across different MCP clients.
+ *
+ * Defines the structure of the configuration file used by client applications
+ * to specify MCP server settings.
+ */
+export interface ClientConfig {
+    /** Dictionary of MCP server configurations, keyed by server identifier. */
+    mcpServers: Record<string, ServerConfig>;
+    /** Additional client-specific configuration fields. */
+    [key: string]: any;
+}
+/**
+ * Interface for client managers responsible for handling client-specific configuration.
+ *
+ * Client managers locate, read, and update configuration files
+ * to integrate MCP server support into client applications.
+ */
+export interface ClientManager {
+    /**
+     * Returns the absolute path to the client's configuration file.
+     *
+     * @returns The full filesystem path to the configuration file.
+     * @throws Error if the configuration directory cannot be created or accessed.
+     */
+    getConfigPath(): string;
+    /**
+     * Updates the client's configuration with OpenZiti MCP server settings.
+     *
+     * @param options - Configuration options, including enabled tools and read-only mode.
+     * @returns A Promise that resolves when the configuration update has been completed successfully.
+     * @throws Error if the configuration cannot be written to disk.
+     */
+    configure(options: ClientOptions): Promise<void>;
+}
+/**
+ * Platform-specific path templates.
+ *
+ * Provides OS-specific configuration directory paths for Darwin (macOS), Windows, and Linux.
+ */
+export interface PlatformPaths {
+    /** Path template for macOS platforms ('darwin'). */
+    darwin: string;
+    /** Path template for Windows platforms ('win32'). */
+    win32: string;
+    /** Path template for Linux platforms ('linux'). */
+    linux: string;
+}

package/dist/clients/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/clients/types.js.map

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

package/dist/clients/utils.d.ts

@@ -0,0 +1,22 @@
+import type { PlatformPaths } from './types.js';
+/**
+ * Ensures that a directory exists on disk.
+ *
+ * If the directory does not already exist, it will be created recursively.
+ * Throws an error if the directory cannot be created.
+ *
+ * @param dir - The absolute path of the directory to ensure exists.
+ * @throws Error if directory creation fails due to filesystem errors.
+ */
+export declare function ensureDir(dir: string): void;
+/**
+ * Resolves the appropriate configuration directory path for the current operating system.
+ *
+ * Accepts an object mapping platform identifiers (`darwin`, `win32`, `linux`) to path templates.
+ * On Windows, replaces `{APPDATA}` placeholders with the actual APPDATA environment variable.
+ *
+ * @param paths - An object containing platform-specific path templates.
+ * @returns The resolved configuration path for the current platform.
+ * @throws Error if the platform is unsupported or required environment variables are missing.
+ */
+export declare function getPlatformPath(paths: PlatformPaths): string;

package/dist/clients/utils.js

@@ -0,0 +1,46 @@
+import * as fs from 'fs';
+/**
+ * Ensures that a directory exists on disk.
+ *
+ * If the directory does not already exist, it will be created recursively.
+ * Throws an error if the directory cannot be created.
+ *
+ * @param dir - The absolute path of the directory to ensure exists.
+ * @throws Error if directory creation fails due to filesystem errors.
+ */
+export function ensureDir(dir) {
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    catch (err) {
+        throw new Error(`Failed to create directory: ${err.message}`);
+    }
+}
+/**
+ * Resolves the appropriate configuration directory path for the current operating system.
+ *
+ * Accepts an object mapping platform identifiers (`darwin`, `win32`, `linux`) to path templates.
+ * On Windows, replaces `{APPDATA}` placeholders with the actual APPDATA environment variable.
+ *
+ * @param paths - An object containing platform-specific path templates.
+ * @returns The resolved configuration path for the current platform.
+ * @throws Error if the platform is unsupported or required environment variables are missing.
+ */
+export function getPlatformPath(paths) {
+    switch (process.platform) {
+        case 'darwin':
+            return paths.darwin;
+        case 'win32': {
+            const APPDATA = process.env.APPDATA;
+            if (!APPDATA) {
+                throw new Error('APPDATA environment variable not set');
+            }
+            return paths.win32.replace('{APPDATA}', APPDATA);
+        }
+        case 'linux':
+            return paths.linux;
+        default:
+            throw new Error(`Unsupported operating system: ${process.platform}`);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/clients/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/clients/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+BAAgC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YACpC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB;YACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/clients/vscode.d.ts

@@ -0,0 +1,76 @@
+import { BaseClientManager } from './base.js';
+import type { ClientOptions } from '../utils/types.js';
+/**
+ * VS Code configuration scope options
+ */
+export type VSCodeScope = 'workspace' | 'global';
+/**
+ * Extended client options for VS Code that includes scope selection
+ */
+export interface VSCodeClientOptions extends ClientOptions {
+    scope?: VSCodeScope;
+    workspaceFolder?: string;
+}
+/**
+ * Client manager implementation for VS Code.
+ *
+ * Responsible for configuring and managing the MCP server integration
+ * for the VS Code editor application with support for both workspace-specific
+ * and global configurations.
+ *
+ * @see {@link https://code.visualstudio.com/ | VS Code Official Website}
+ */
+export declare class VSCodeClientManager extends BaseClientManager {
+    private selectedScope;
+    private selectedWorkspaceFolder?;
+    constructor();
+    /**
+     * Returns the path to the VS Code configuration file.
+     * Uses the currently selected scope and workspace folder.
+     *
+     * @returns The absolute path to the configuration file.
+     */
+    getConfigPath(): string;
+    /**
+     * Returns the path to the global VS Code configuration file.
+     *
+     * @returns The absolute path to the global configuration file.
+     */
+    private getGlobalConfigPath;
+    /**
+     * Prompts user to select between workspace and global scope.
+     *
+     * @returns Promise resolving to the selected scope
+     */
+    private promptForScope;
+    /**
+     * Prompts user for workspace folder path.
+     *
+     * @returns Promise resolving to the validated workspace folder path
+     */
+    private promptForWorkspaceFolder;
+    /**
+     * Enhanced configure method that handles VS Code-specific scope selection.
+     *
+     * First prompts for configuration scope (workspace vs global), then if workspace
+     * is selected, prompts for the project folder path.
+     *
+     * @param options - Client configuration options
+     */
+    configure(options: VSCodeClientOptions): Promise<void>;
+    /**
+     * Loads VS Code-specific configuration from disk.
+     * VS Code uses settings.json format, not the mcpServers format used by other clients.
+     *
+     * @param configPath - Path to the VS Code settings file
+     * @returns Parsed configuration object
+     */
+    private readVSCodeConfig;
+    /**
+     * Writes VS Code configuration to disk with proper formatting.
+     *
+     * @param configPath - Path where the configuration should be saved
+     * @param config - Configuration object to serialize and write
+     */
+    private writeVSCodeConfig;
+}

package/dist/clients/vscode.js

@@ -0,0 +1,159 @@
+import * as path from 'path';
+import * as os from 'os';
+import * as fs from 'fs';
+import chalk from 'chalk';
+import { BaseClientManager } from './base.js';
+import { getPlatformPath, ensureDir } from './utils.js';
+import { log } from '../utils/logger.js';
+import { cliOutput, promptForChoice, promptForPath } from '../utils/terminal.js';
+/**
+ * Client manager implementation for VS Code.
+ *
+ * Responsible for configuring and managing the MCP server integration
+ * for the VS Code editor application with support for both workspace-specific
+ * and global configurations.
+ *
+ * @see {@link https://code.visualstudio.com/ | VS Code Official Website}
+ */
+export class VSCodeClientManager extends BaseClientManager {
+    selectedScope = 'global';
+    selectedWorkspaceFolder;
+    constructor() {
+        super({
+            clientType: 'vscode',
+            displayName: 'VS Code',
+        });
+    }
+    /**
+     * Returns the path to the VS Code configuration file.
+     * Uses the currently selected scope and workspace folder.
+     *
+     * @returns The absolute path to the configuration file.
+     */
+    getConfigPath() {
+        if (this.selectedScope === 'workspace') {
+            if (!this.selectedWorkspaceFolder) {
+                // Fallback to global if workspace folder not set
+                return this.getGlobalConfigPath();
+            }
+            if (!fs.existsSync(this.selectedWorkspaceFolder)) {
+                throw new Error(`Workspace folder does not exist: ${this.selectedWorkspaceFolder}`);
+            }
+            const vscodeDir = path.join(this.selectedWorkspaceFolder, '.vscode');
+            ensureDir(vscodeDir);
+            return path.join(vscodeDir, 'mcp.json');
+        }
+        return this.getGlobalConfigPath();
+    }
+    /**
+     * Returns the path to the global VS Code configuration file.
+     *
+     * @returns The absolute path to the global configuration file.
+     */
+    getGlobalConfigPath() {
+        const configDir = getPlatformPath({
+            darwin: path.join(os.homedir(), 'Library', 'Application Support', 'Code', 'User'),
+            win32: path.join('{APPDATA}', 'Code', 'User'),
+            linux: path.join(os.homedir(), '.config', 'Code', 'User'),
+        });
+        ensureDir(configDir);
+        return path.join(configDir, 'mcp.json');
+    }
+    /**
+     * Prompts user to select between workspace and global scope.
+     *
+     * @returns Promise resolving to the selected scope
+     */
+    async promptForScope() {
+        return promptForChoice('Where would you like to configure the OpenZiti MCP server for VS Code?', [
+            {
+                label: 'Workspace - Configure for a specific project/repository',
+                value: 'workspace',
+            },
+            { label: 'Global - Configure for all VS Code instances', value: 'global' },
+        ], 'workspace');
+    }
+    /**
+     * Prompts user for workspace folder path.
+     *
+     * @returns Promise resolving to the validated workspace folder path
+     */
+    async promptForWorkspaceFolder() {
+        return promptForPath('Enter the absolute path to your workspace/project folder: ', {
+            required: true,
+            mustExist: true,
+            mustBeDirectory: true,
+        });
+    }
+    /**
+     * Enhanced configure method that handles VS Code-specific scope selection.
+     *
+     * First prompts for configuration scope (workspace vs global), then if workspace
+     * is selected, prompts for the project folder path.
+     *
+     * @param options - Client configuration options
+     */
+    async configure(options) {
+        // Set scope from options or prompt user
+        if (options.scope) {
+            this.selectedScope = options.scope;
+            this.selectedWorkspaceFolder = options.workspaceFolder;
+        }
+        else {
+            this.selectedScope = await this.promptForScope();
+        }
+        // If workspace scope but no folder specified, prompt for it
+        if (this.selectedScope === 'workspace' && !this.selectedWorkspaceFolder) {
+            this.selectedWorkspaceFolder = await this.promptForWorkspaceFolder();
+        }
+        const configPath = this.getConfigPath();
+        const config = this.readVSCodeConfig(configPath);
+        const serverConfig = this.createServerConfig(options);
+        // VS Code uses a different configuration structure for MCP
+        if (!config['servers']) {
+            config['servers'] = {};
+        }
+        config['servers']['ziti'] = serverConfig;
+        this.writeVSCodeConfig(configPath, config);
+        const scopeDescription = this.selectedScope === 'workspace' ? `workspace (${this.selectedWorkspaceFolder})` : 'global';
+        log(`Updated ${this.displayName} ${scopeDescription} config file at: ${configPath}`);
+        if (this.selectedScope === 'workspace') {
+            cliOutput(`\n${chalk.green('✓')} OpenZiti MCP server configured for workspace.\n` +
+                `${chalk.yellow('Note:')} Make sure to open VS Code in the workspace folder: ${this.selectedWorkspaceFolder}\n` +
+                `${chalk.yellow('Restart VS Code')} to apply changes.\n`);
+        }
+        else {
+            cliOutput(`\n${chalk.green('✓')} OpenZiti MCP server configured globally for ${this.displayName}.\n` +
+                `${chalk.yellow('Restart VS Code')} to apply changes.\n`);
+        }
+    }
+    /**
+     * Loads VS Code-specific configuration from disk.
+     * VS Code uses settings.json format, not the mcpServers format used by other clients.
+     *
+     * @param configPath - Path to the VS Code settings file
+     * @returns Parsed configuration object
+     */
+    readVSCodeConfig(configPath) {
+        if (fs.existsSync(configPath)) {
+            try {
+                const data = fs.readFileSync(configPath, 'utf-8');
+                return JSON.parse(data);
+            }
+            catch (err) {
+                log(`Warning: Could not read VS Code config at ${configPath}: ${err}`);
+            }
+        }
+        return {};
+    }
+    /**
+     * Writes VS Code configuration to disk with proper formatting.
+     *
+     * @param configPath - Path where the configuration should be saved
+     * @param config - Configuration object to serialize and write
+     */
+    writeVSCodeConfig(configPath, config) {
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+}
+//# sourceMappingURL=vscode.js.map

package/dist/clients/vscode.js.map

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

package/dist/clients/windsurf.d.ts

@@ -0,0 +1,22 @@
+import { BaseClientManager } from './base.js';
+/**
+ * Client manager implementation for Windsurf.
+ *
+ * Responsible for configuring and managing the MCP server integration
+ * for the Windsurf Editor application.
+ *
+ * @see {@link https://windsurf.com/editor | Windsurf Editor}
+ */
+export declare class WindsurfClientManager extends BaseClientManager {
+    constructor();
+    /**
+     * Returns the path to the Windsurf configuration file.
+     *
+     * Resolves the platform-specific configuration directory,
+     * ensures the directory exists on disk, and constructs the full path
+     * to the MCP configuration file.
+     *
+     * @returns The absolute path to the configuration file.
+     */
+    getConfigPath(): string;
+}

package/dist/clients/windsurf.js

@@ -0,0 +1,39 @@
+import * as path from 'path';
+import * as os from 'os';
+import { BaseClientManager } from './base.js';
+import { getPlatformPath, ensureDir } from './utils.js';
+/**
+ * Client manager implementation for Windsurf.
+ *
+ * Responsible for configuring and managing the MCP server integration
+ * for the Windsurf Editor application.
+ *
+ * @see {@link https://windsurf.com/editor | Windsurf Editor}
+ */
+export class WindsurfClientManager extends BaseClientManager {
+    constructor() {
+        super({
+            clientType: 'windsurf',
+            displayName: 'Windsurf',
+        });
+    }
+    /**
+     * Returns the path to the Windsurf configuration file.
+     *
+     * Resolves the platform-specific configuration directory,
+     * ensures the directory exists on disk, and constructs the full path
+     * to the MCP configuration file.
+     *
+     * @returns The absolute path to the configuration file.
+     */
+    getConfigPath() {
+        const configDir = getPlatformPath({
+            darwin: path.join(os.homedir(), '.codeium', 'windsurf'),
+            win32: path.join('{APPDATA}', '.codeium', 'windsurf'),
+            linux: path.join(os.homedir(), '.codeium', 'windsurf'),
+        });
+        ensureDir(configDir);
+        return path.join(configDir, 'mcp_config.json');
+    }
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/clients/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/clients/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAC1D;QACE,KAAK,CAAC;YACJ,UAAU,EAAE,UAAU;YACtB,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa;QACX,MAAM,SAAS,GAAG,eAAe,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC;YACvD,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC;YACrD,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC;SACvD,CAAC,CAAC;QAEH,SAAS,CAAC,SAAS,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACjD,CAAC;CACF"}