@utaba/ucm-mcp-server 4.0.0 → 4.2.0

package/README.md

@@ -6,7 +6,7 @@ Get your auth token from https://ucm.utaba.ai
 
 ## Configuration
 
-- `--auth-token <token>` (required): Authentication token in format `{apikey}`
+- `--auth-token <token>` (required): Authentication token in format `{authorid}:{apikey}`
 
 ## Available MCP Tools
 

package/dist/clients/UcmApiClient.d.ts

@@ -1,10 +1,11 @@
+import https from 'https';
 import { ArtifactData, AuthorData } from '../types/UcmApiTypes.js';
 export declare class UcmLocalApiClient {
     private baseUrl;
     private authToken?;
     private authorId?;
     private client;
-    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined);
+    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined, httpsAgent?: https.Agent);
     private setupInterceptors;
     private ensureClient;
     getAuthors(): Promise<AuthorData[]>;

package/dist/clients/UcmApiClient.js

@@ -4,7 +4,7 @@ export class UcmLocalApiClient {
     authToken;
     authorId;
     client;
-    constructor(baseUrl, authToken, timeout = 600000, authorId) {
+    constructor(baseUrl, authToken, timeout = 600000, authorId, httpsAgent) {
         this.baseUrl = baseUrl;
         this.authToken = authToken;
         this.authorId = authorId;
@@ -14,7 +14,8 @@ export class UcmLocalApiClient {
             headers: {
                 'Content-Type': 'application/json',
                 ...(authToken && { 'Authorization': `Bearer ${authToken}` })
-            }
+            },
+            ...(httpsAgent && { httpsAgent })
         });
         this.setupInterceptors();
     }
@@ -187,7 +188,8 @@ export class UcmLocalApiClient {
         if (data.queryParams) {
             // New API structure with query params
             Object.entries(data.queryParams).forEach(([key, value]) => {
-                if (value !== undefined && value !== null && value !== '') {
+                // Skip if value is undefined, null, empty string, or string "null"/"undefined"
+                if (value !== undefined && value !== null && value !== '' && value !== 'null' && value !== 'undefined') {
                     // Handle arrays (e.g., tags) by JSON stringifying them
                     if (Array.isArray(value)) {
                         params.append(key, JSON.stringify(value));
@@ -221,7 +223,8 @@ export class UcmLocalApiClient {
         if (data.queryParams) {
             // New API structure with query params
             Object.entries(data.queryParams).forEach(([key, value]) => {
-                if (value !== undefined && value !== null && value !== '') {
+                // Skip if value is undefined, null, empty string, or string "null"/"undefined"
+                if (value !== undefined && value !== null && value !== '' && value !== 'null' && value !== 'undefined') {
                     // Handle arrays (e.g., tags) by JSON stringifying them
                     if (Array.isArray(value)) {
                         params.append(key, JSON.stringify(value));

package/dist/index.js

@@ -12,12 +12,12 @@ async function main() {
     program
         .name('ucm-mcp-server')
         .description('Universal Context Manager - Read the ucm_connect tool first to avoid mistakes')
-        .version('1.0.5')
+        .version('4.1.0')
         .option('-u, --ucm-url <url>', 'UCM API base URL (defaults to https://ucm.utaba.ai)')
         .option('-p, --port <port>', 'Server port', '3001')
         .option('--log-level <level>', 'Log level', 'ERROR')
         .option('--auth-token <token>', 'Authentication token for UCM API format is {auhtorid}:{apikey}. Get one from https://ucm.utaba.ai')
-        .option('--trusted-authors <authors>', 'Comma-separated list of trusted authors (e.g., "utaba,{anotherauthor}")', "utaba")
+        .option('--ca-cert <path>', 'Path to CA certificate file (PEM format) for self-signed certificates')
         .parse();
     const options = program.opts();
     const config = new McpConfig({
@@ -25,7 +25,8 @@ async function main() {
         port: parseInt(options.port),
         logLevel: options.logLevel,
         authToken: options.authToken,
-        trustedAuthors: options.trustedAuthors ? options.trustedAuthors.split(',').map((a) => a.trim()) : ["utaba"]
+        trustedAuthors: options.trustedAuthors ? options.trustedAuthors.split(',').map((a) => a.trim()) : ["utaba"],
+        caCertPath: options.caCert
     });
     // Set the log level in the factory before creating any loggers
     LoggerFactory.setLogLevel(config.logLevel);

package/dist/server/McpConfig.d.ts

@@ -6,6 +6,7 @@ export interface McpServerConfig {
     logLevel: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
     requestTimeout: number;
     trustedAuthors: string[];
+    caCertPath?: string;
 }
 export declare class McpConfig {
     private config;
@@ -21,6 +22,7 @@ export declare class McpConfig {
     get requestTimeout(): number;
     get trustedAuthors(): string[];
     get authorId(): string | undefined;
+    get caCertPath(): string | undefined;
     getFullConfig(): McpServerConfig;
 }
 //# sourceMappingURL=McpConfig.d.ts.map

package/dist/server/McpConfig.js

@@ -12,7 +12,8 @@ export class McpConfig {
             authorId: options.authorId || authorId,
             logLevel: options.logLevel || this.getEnvVar('MCP_LOG_LEVEL', 'ERROR'),
             requestTimeout: options.requestTimeout || parseInt(this.getEnvVar('MCP_REQUEST_TIMEOUT', '30000')),
-            trustedAuthors: options.trustedAuthors || this.parseTrustedAuthors(this.getEnvVar('MCP_TRUSTED_AUTHORS', ''))
+            trustedAuthors: options.trustedAuthors || this.parseTrustedAuthors(this.getEnvVar('MCP_TRUSTED_AUTHORS', '')),
+            caCertPath: options.caCertPath
         };
         this.validateConfig();
     }
@@ -82,6 +83,9 @@ export class McpConfig {
     get authorId() {
         return this.config.authorId;
     }
+    get caCertPath() {
+        return this.config.caCertPath;
+    }
     // Get full configuration object (for testing and debugging)
     getFullConfig() {
         return { ...this.config };

package/dist/server/McpServer.js

@@ -4,6 +4,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextpro
 import { McpHandler } from './McpHandler.js';
 import { UcmLocalApiClient } from '../clients/UcmApiClient.js';
 import { ToolRegistry } from './ToolRegistry.js';
+import { HttpsAgentFactory } from '../utils/HttpsAgentFactory.js';
 export class McpServer {
     config;
     logger;
@@ -14,7 +15,11 @@ export class McpServer {
     constructor(config, logger) {
         this.config = config;
         this.logger = logger;
-        this.ucmClient = new UcmLocalApiClient(config.ucmApiUrl, config.authToken, config.requestTimeout, config.authorId);
+        // Create HTTPS agent with custom CA certificate if provided
+        const httpsAgent = config.caCertPath
+            ? HttpsAgentFactory.createAgent({ caCertPath: config.caCertPath }, logger)
+            : undefined;
+        this.ucmClient = new UcmLocalApiClient(config.ucmApiUrl, config.authToken, config.requestTimeout, config.authorId, httpsAgent);
         this.toolRegistry = new ToolRegistry(this.ucmClient, this.logger, config.trustedAuthors, config.authorId, config.ucmApiUrl);
         this.handler = new McpHandler(this.toolRegistry, this.logger, config.authorId);
         this.server = new Server({

package/dist/server/ToolRegistry.d.ts

@@ -1,4 +1,4 @@
-import { UcmLocalApiClient } from '../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../clients/UcmLocalApiClient.js';
 import { ILogger } from '../interfaces/ILogger.js';
 export interface ToolInfo {
     name: string;

package/dist/tools/artifacts/GetArtifactController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetArtifactController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/artifacts/GetLatestController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetLatestController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/artifacts/ListVersionsController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListVersionsController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/artifacts/PublishArtifactController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class PublishArtifactController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/base/BaseToolController.d.ts

@@ -1,5 +1,5 @@
 import { IMcpTool } from '../../interfaces/IMcpTool.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare abstract class BaseToolController implements IMcpTool {
     protected ucmClient: UcmLocalApiClient;

package/dist/tools/core/DeleteArtifactTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class DeleteArtifactTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/core/EditArtifactMetadataTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class EditArtifactMetadataTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/core/EditArtifactMetadataTool.js

@@ -9,7 +9,7 @@ export class EditArtifactMetadataTool extends BaseToolController {
         return 'ucm_edit_artifact_metadata';
     }
     get description() {
-        return 'Edit artifact metadata and optionally move artifacts to new locations. Supports updating description, namespace, filename, MIME type, technology, and tags. Move operations affect all versions while metadata-only updates apply to latest version only.';
+        return 'Edit artifact metadata and move artifacts. Supports updating description, namespace, filename, MIME type, technology, and tags. Move operations affect all versions while metadata-only updates apply to latest version only.';
     }
     get inputSchema() {
         return {

package/dist/tools/core/GetArtifactTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetArtifactTool extends BaseToolController {
     private trustedAuthors;

package/dist/tools/core/GetArtifactVersionsTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetArtifactVersionsTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/core/GetChunkTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetChunkTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/core/ListArtifactsTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListArtifactsTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/core/PublishArtifactFromFileTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class PublishArtifactFromFileTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/core/PublishArtifactTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class PublishArtifactTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/core/SearchArtifactsTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class SearchArtifactsTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/discovery/BrowseCategoriesController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class BrowseCategoriesController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/discovery/FindByPurposeController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class FindByPurposeController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/discovery/ListAuthorsController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListAuthorsController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/discovery/SearchArtifactsController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class SearchArtifactsController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/navigation/ExploreNamespaceController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ExploreNamespaceController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/tools/repository/CreateRepositoryTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class CreateRepositoryTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/repository/DeleteRepositoryGuidanceTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class DeleteRepositoryGuidanceTool extends BaseToolController {
     private baseUrl?;

package/dist/tools/repository/GetRepositoryTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetRepositoryTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/repository/UpdateRepositoryTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class UpdateRepositoryTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/utility/AuthorIndexTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class AuthorIndexTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/utility/AuthorRecentsTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class AuthorRecentsTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/utility/HealthCheckController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class HealthCheckController extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/utility/ListRepositoriesTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListRepositoriesTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/utility/QuickstartTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class QuickstartTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/utility/SubmitFeedbackTool.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class SubmitFeedbackTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);

package/dist/tools/utility/ValidatePathController.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ValidatePathController extends BaseToolController {
     constructor(ucmClient: UcmApiClient, logger: ILogger);

package/dist/utils/HttpsAgentFactory.d.ts

@@ -0,0 +1,21 @@
+import https from 'https';
+import { ILogger } from '../interfaces/ILogger.js';
+export interface HttpsAgentOptions {
+    caCertPath?: string;
+}
+/**
+ * Factory for creating HTTPS agents with custom CA certificate support
+ * Enables secure connections to self-signed certificate environments
+ */
+export declare class HttpsAgentFactory {
+    /**
+     * Create an HTTPS agent with optional custom CA certificate
+     *
+     * @param options - Configuration options for the HTTPS agent
+     * @param logger - Logger instance for diagnostic messages
+     * @returns https.Agent configured with custom CA if provided, otherwise undefined
+     * @throws Error if certificate file cannot be read or is invalid
+     */
+    static createAgent(options: HttpsAgentOptions, logger?: ILogger): https.Agent | undefined;
+}
+//# sourceMappingURL=HttpsAgentFactory.d.ts.map

package/dist/utils/HttpsAgentFactory.js

@@ -0,0 +1,50 @@
+import https from 'https';
+import fs from 'fs';
+/**
+ * Factory for creating HTTPS agents with custom CA certificate support
+ * Enables secure connections to self-signed certificate environments
+ */
+export class HttpsAgentFactory {
+    /**
+     * Create an HTTPS agent with optional custom CA certificate
+     *
+     * @param options - Configuration options for the HTTPS agent
+     * @param logger - Logger instance for diagnostic messages
+     * @returns https.Agent configured with custom CA if provided, otherwise undefined
+     * @throws Error if certificate file cannot be read or is invalid
+     */
+    static createAgent(options, logger) {
+        // If no CA certificate path provided, return undefined to use default behavior
+        if (!options.caCertPath) {
+            return undefined;
+        }
+        try {
+            // Load the CA certificate from file
+            const caCert = fs.readFileSync(options.caCertPath, 'utf-8');
+            // Create HTTPS agent with custom CA certificate
+            // rejectUnauthorized: true ensures full certificate validation is maintained
+            const agent = new https.Agent({
+                ca: caCert
+            });
+            if (logger) {
+                logger.info('HttpsAgentFactory', `✓ Loaded CA certificate from: ${options.caCertPath}`);
+            }
+            return agent;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const detailedMessage = `Failed to load CA certificate from ${options.caCertPath}: ${errorMessage}`;
+            if (logger) {
+                logger.warn('HttpsAgentFactory', detailedMessage);
+                logger.warn('HttpsAgentFactory', 'Continuing without custom CA certificate - using default certificate validation');
+            }
+            else {
+                console.warn(`⚠️  ${detailedMessage}`);
+                console.warn('⚠️  Continuing without custom CA certificate - using default certificate validation');
+            }
+            // Return undefined to fall back to default behavior instead of crashing
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=HttpsAgentFactory.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",

package/package.json.backup

@@ -1,6 +1,6 @@
 {
   "name": "ucm-mcp-server",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",