mcp-use 0.1.19 → 0.2.0

package/dist/src/adapters/langchain_adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langchain_adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/langchain_adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAIV,IAAI,IAAI,OAAO,EAEhB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAM1D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAuDvC,qBAAa,gBAAiB,SAAQ,WAAW,CAAC,uBAAuB,CAAC;gBAC5D,eAAe,GAAE,MAAM,EAAO;IAI1C;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,GACvB,uBAAuB,GAAG,IAAI;CA8BlC"}
+{"version":3,"file":"langchain_adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/langchain_adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAEV,IAAI,IAAI,OAAO,EAChB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAM1D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAYvC,qBAAa,gBAAiB,SAAQ,WAAW,CAAC,uBAAuB,CAAC;gBAC5D,eAAe,GAAE,MAAM,EAAO;IAI1C;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,GACvB,uBAAuB,GAAG,IAAI;CA8BlC"}

package/dist/src/adapters/langchain_adapter.js

@@ -12,47 +12,6 @@ function schemaToZod(schema) {
         return z.any();
     }
 }
-function parseMcpToolResult(toolResult) {
-    if (toolResult.isError) {
-        throw new Error(`Tool execution failed: ${toolResult.content}`);
-    }
-    if (!toolResult.content || toolResult.content.length === 0) {
-        throw new Error('Tool execution returned no content');
-    }
-    let decoded = '';
-    for (const item of toolResult.content) {
-        switch (item.type) {
-            case 'text': {
-                decoded += item.text;
-                break;
-            }
-            case 'image': {
-                decoded += item.data;
-                break;
-            }
-            case 'resource': {
-                const res = item.resource;
-                if (res?.text !== undefined) {
-                    decoded += res.text;
-                }
-                else if (res?.blob !== undefined) {
-                    // eslint-disable-next-line node/prefer-global/buffer
-                    decoded += res.blob instanceof Uint8Array || res.blob instanceof Buffer
-                        // eslint-disable-next-line node/prefer-global/buffer
-                        ? Buffer.from(res.blob).toString('base64')
-                        : String(res.blob);
-                }
-                else {
-                    throw new Error(`Unexpected resource type: ${res?.type}`);
-                }
-                break;
-            }
-            default:
-                throw new Error(`Unexpected content type: ${item.type}`);
-        }
-    }
-    return decoded;
-}
 export class LangChainAdapter extends BaseAdapter {
     constructor(disallowedTools = []) {
         super(disallowedTools);
@@ -77,7 +36,7 @@ export class LangChainAdapter extends BaseAdapter {
                 logger.debug(`MCP tool \"${mcpTool.name}\" received input: ${JSON.stringify(input)}`);
                 try {
                     const result = await connector.callTool(mcpTool.name, input);
-                    return parseMcpToolResult(result);
+                    return JSON.stringify(result);
                 }
                 catch (err) {
                     logger.error(`Error executing MCP tool: ${err.message}`);

package/dist/src/browser.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Browser-compatible exports for mcp-use
+ *
+ * This module provides browser-safe versions of mcp-use components
+ * that avoid Node.js-specific dependencies (like fs, path for file operations).
+ *
+ * The actual MCP protocol connectors (WebSocket, HTTP/SSE) work fine in browsers.
+ */
+import type { BaseConnector } from './connectors/base.js';
+import { BaseMCPClient } from './client/base.js';
+import { HttpConnector } from './connectors/http.js';
+import { WebSocketConnector } from './connectors/websocket.js';
+import { logger } from './logging.js';
+import { MCPSession } from './session.js';
+/**
+ * Browser-compatible MCP Client
+ *
+ * Unlike the Node.js version, this doesn't support:
+ * - Loading config from files (loadConfigFile)
+ * - Saving config to files (saveConfig)
+ * - StdioConnector (requires child_process)
+ *
+ * Supported connectors:
+ * - WebSocketConnector: Connect to MCP servers via WebSocket
+ * - HttpConnector: Connect to MCP servers via HTTP/SSE
+ */
+export declare class MCPClient extends BaseMCPClient {
+    constructor(config?: Record<string, any>);
+    static fromDict(cfg: Record<string, any>): MCPClient;
+    /**
+     * Create a connector from server configuration (browser-safe version)
+     *
+     * Supports:
+     * - WebSocket connections: { ws_url: "ws://..." }
+     * - HTTP connections: { url: "http://..." }
+     *
+     * Does NOT support:
+     * - Stdio connections: { command: "...", args: [...] }
+     */
+    protected createConnectorFromConfig(serverConfig: Record<string, any>): BaseConnector;
+}
+export { HttpConnector, WebSocketConnector };
+export { MCPSession };
+export { logger };
+export { createOAuthMCPConfig, LINEAR_OAUTH_CONFIG, OAuthHelper } from './oauth-helper.js';
+export type { ClientRegistration, OAuthConfig, OAuthDiscovery, OAuthResult, OAuthState } from './oauth-helper.js';
+export type { AIMessage, BaseMessage, HumanMessage, SystemMessage, ToolMessage } from '@langchain/core/messages';
+export type { StreamEvent } from '@langchain/core/tracers/log_stream';
+//# sourceMappingURL=browser.d.ts.map

package/dist/src/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;GAWG;AACH,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;WAI1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAI3D;;;;;;;;;OASG;IACH,SAAS,CAAC,yBAAyB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;CA8BtF;AAGD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAA;AAG5C,OAAO,EAAE,UAAU,EAAE,CAAA;AAGrB,OAAO,EAAE,MAAM,EAAE,CAAA;AAGjB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC1F,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGjH,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAChH,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA"}

package/dist/src/browser.js

@@ -0,0 +1,75 @@
+/**
+ * Browser-compatible exports for mcp-use
+ *
+ * This module provides browser-safe versions of mcp-use components
+ * that avoid Node.js-specific dependencies (like fs, path for file operations).
+ *
+ * The actual MCP protocol connectors (WebSocket, HTTP/SSE) work fine in browsers.
+ */
+import { BaseMCPClient } from './client/base.js';
+import { HttpConnector } from './connectors/http.js';
+import { WebSocketConnector } from './connectors/websocket.js';
+import { logger } from './logging.js';
+import { MCPSession } from './session.js';
+/**
+ * Browser-compatible MCP Client
+ *
+ * Unlike the Node.js version, this doesn't support:
+ * - Loading config from files (loadConfigFile)
+ * - Saving config to files (saveConfig)
+ * - StdioConnector (requires child_process)
+ *
+ * Supported connectors:
+ * - WebSocketConnector: Connect to MCP servers via WebSocket
+ * - HttpConnector: Connect to MCP servers via HTTP/SSE
+ */
+export class MCPClient extends BaseMCPClient {
+    constructor(config) {
+        super(config);
+    }
+    static fromDict(cfg) {
+        return new MCPClient(cfg);
+    }
+    /**
+     * Create a connector from server configuration (browser-safe version)
+     *
+     * Supports:
+     * - WebSocket connections: { ws_url: "ws://..." }
+     * - HTTP connections: { url: "http://..." }
+     *
+     * Does NOT support:
+     * - Stdio connections: { command: "...", args: [...] }
+     */
+    createConnectorFromConfig(serverConfig) {
+        // WebSocket connector
+        if ('ws_url' in serverConfig) {
+            return new WebSocketConnector(serverConfig.ws_url, {
+                headers: serverConfig.headers,
+                authToken: serverConfig.auth_token || serverConfig.authToken,
+            });
+        }
+        // HTTP/SSE connector
+        if ('url' in serverConfig) {
+            const transport = serverConfig.transport || 'http';
+            return new HttpConnector(serverConfig.url, {
+                headers: serverConfig.headers,
+                authToken: serverConfig.auth_token || serverConfig.authToken,
+                preferSse: serverConfig.preferSse || transport === 'sse',
+            });
+        }
+        // Stdio is not supported in browser
+        if ('command' in serverConfig && 'args' in serverConfig) {
+            throw new Error('StdioConnector is not supported in browser environments. '
+                + 'Use WebSocket (ws_url) or HTTP (url) connectors instead.');
+        }
+        throw new Error('Cannot determine connector type from config. Use "url" for HTTP or "ws_url" for WebSocket.');
+    }
+}
+// Re-export browser-safe connectors
+export { HttpConnector, WebSocketConnector };
+// Re-export session
+export { MCPSession };
+// Re-export logger (already browser-safe)
+export { logger };
+// Re-export OAuth helper for browser authentication
+export { createOAuthMCPConfig, LINEAR_OAUTH_CONFIG, OAuthHelper } from './oauth-helper.js';

package/dist/src/client/base.d.ts

@@ -0,0 +1,32 @@
+import type { BaseConnector } from '../connectors/base.js';
+import { MCPSession } from '../session.js';
+/**
+ * Base MCPClient class with shared functionality
+ *
+ * This class contains all the common logic that works in both Node.js and browser environments.
+ * Platform-specific implementations should extend this class and override methods as needed.
+ */
+export declare abstract class BaseMCPClient {
+    protected config: Record<string, any>;
+    protected sessions: Record<string, MCPSession>;
+    activeSessions: string[];
+    constructor(config?: Record<string, any>);
+    static fromDict(_cfg: Record<string, any>): BaseMCPClient;
+    addServer(name: string, serverConfig: Record<string, any>): void;
+    removeServer(name: string): void;
+    getServerNames(): string[];
+    getServerConfig(name: string): Record<string, any>;
+    getConfig(): Record<string, any>;
+    /**
+     * Create a connector from server configuration
+     * This method must be implemented by platform-specific subclasses
+     */
+    protected abstract createConnectorFromConfig(serverConfig: Record<string, any>): BaseConnector;
+    createSession(serverName: string, autoInitialize?: boolean): Promise<MCPSession>;
+    createAllSessions(autoInitialize?: boolean): Promise<Record<string, MCPSession>>;
+    getSession(serverName: string): MCPSession | null;
+    getAllActiveSessions(): Record<string, MCPSession>;
+    closeSession(serverName: string): Promise<void>;
+    closeAllSessions(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/client/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/client/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C;;;;;GAKG;AACH,8BAAsB,aAAa;IACjC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAK;IAC1C,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAK;IAC5C,cAAc,EAAE,MAAM,EAAE,CAAK;gBAExB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;WAM1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;IAKzD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKhE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhC,cAAc,IAAI,MAAM,EAAE;IAI1B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIlD,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIvC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,yBAAyB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;IAEjF,aAAa,CACxB,UAAU,EAAE,MAAM,EAClB,cAAc,UAAO,GACpB,OAAO,CAAC,UAAU,CAAC;IAyBT,iBAAiB,CAC5B,cAAc,UAAO,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAc/B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQjD,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAM5C,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB/C"}

package/dist/src/client/base.js

@@ -0,0 +1,119 @@
+import { logger } from '../logging.js';
+import { MCPSession } from '../session.js';
+/**
+ * Base MCPClient class with shared functionality
+ *
+ * This class contains all the common logic that works in both Node.js and browser environments.
+ * Platform-specific implementations should extend this class and override methods as needed.
+ */
+export class BaseMCPClient {
+    config = {};
+    sessions = {};
+    activeSessions = [];
+    constructor(config) {
+        if (config) {
+            this.config = config;
+        }
+    }
+    static fromDict(_cfg) {
+        // This will be overridden by concrete implementations
+        throw new Error('fromDict must be implemented by concrete class');
+    }
+    addServer(name, serverConfig) {
+        this.config.mcpServers = this.config.mcpServers || {};
+        this.config.mcpServers[name] = serverConfig;
+    }
+    removeServer(name) {
+        if (this.config.mcpServers?.[name]) {
+            delete this.config.mcpServers[name];
+            this.activeSessions = this.activeSessions.filter(n => n !== name);
+        }
+    }
+    getServerNames() {
+        return Object.keys(this.config.mcpServers ?? {});
+    }
+    getServerConfig(name) {
+        return this.config.mcpServers?.[name];
+    }
+    getConfig() {
+        return this.config ?? {};
+    }
+    async createSession(serverName, autoInitialize = true) {
+        const servers = this.config.mcpServers ?? {};
+        if (Object.keys(servers).length === 0) {
+            logger.warn('No MCP servers defined in config');
+        }
+        if (!servers[serverName]) {
+            throw new Error(`Server '${serverName}' not found in config`);
+        }
+        const connector = this.createConnectorFromConfig(servers[serverName]);
+        const session = new MCPSession(connector);
+        if (autoInitialize) {
+            await session.initialize();
+        }
+        this.sessions[serverName] = session;
+        if (!this.activeSessions.includes(serverName)) {
+            this.activeSessions.push(serverName);
+        }
+        return session;
+    }
+    async createAllSessions(autoInitialize = true) {
+        const servers = this.config.mcpServers ?? {};
+        if (Object.keys(servers).length === 0) {
+            logger.warn('No MCP servers defined in config');
+        }
+        for (const name of Object.keys(servers)) {
+            await this.createSession(name, autoInitialize);
+        }
+        return this.sessions;
+    }
+    getSession(serverName) {
+        const session = this.sessions[serverName];
+        if (!session) {
+            return null;
+        }
+        return session;
+    }
+    getAllActiveSessions() {
+        return Object.fromEntries(this.activeSessions.map(n => [n, this.sessions[n]]));
+    }
+    async closeSession(serverName) {
+        const session = this.sessions[serverName];
+        if (!session) {
+            logger.warn(`No session exists for server ${serverName}, nothing to close`);
+            return;
+        }
+        try {
+            logger.debug(`Closing session for server ${serverName}`);
+            await session.disconnect();
+        }
+        catch (e) {
+            logger.error(`Error closing session for server '${serverName}': ${e}`);
+        }
+        finally {
+            delete this.sessions[serverName];
+            this.activeSessions = this.activeSessions.filter(n => n !== serverName);
+        }
+    }
+    async closeAllSessions() {
+        const serverNames = Object.keys(this.sessions);
+        const errors = [];
+        for (const serverName of serverNames) {
+            try {
+                logger.debug(`Closing session for server ${serverName}`);
+                await this.closeSession(serverName);
+            }
+            catch (e) {
+                const errorMsg = `Failed to close session for server '${serverName}': ${e}`;
+                logger.error(errorMsg);
+                errors.push(errorMsg);
+            }
+        }
+        if (errors.length) {
+            logger.error(`Encountered ${errors.length} errors while closing sessions`);
+        }
+        else {
+            logger.debug('All sessions closed successfully');
+        }
+    }
+}

package/dist/src/client.d.ts

@@ -1,22 +1,25 @@
-import { MCPSession } from './session.js';
-export declare class MCPClient {
-    private config;
-    private sessions;
-    activeSessions: string[];
+import type { BaseConnector } from './connectors/base.js';
+import { BaseMCPClient } from './client/base.js';
+/**
+ * Node.js-specific MCPClient implementation
+ *
+ * Extends the base client with Node.js-specific features like:
+ * - File system operations (saveConfig)
+ * - Config file loading (fromConfigFile)
+ * - All connector types including StdioConnector
+ */
+export declare class MCPClient extends BaseMCPClient {
     constructor(config?: string | Record<string, any>);
     static fromDict(cfg: Record<string, any>): MCPClient;
     static fromConfigFile(path: string): MCPClient;
-    addServer(name: string, serverConfig: Record<string, any>): void;
-    removeServer(name: string): void;
-    getServerNames(): string[];
-    getServerConfig(name: string): Record<string, any>;
-    getConfig(): Record<string, any>;
+    /**
+     * Save configuration to a file (Node.js only)
+     */
     saveConfig(filepath: string): void;
-    createSession(serverName: string, autoInitialize?: boolean): Promise<MCPSession>;
-    createAllSessions(autoInitialize?: boolean): Promise<Record<string, MCPSession>>;
-    getSession(serverName: string): MCPSession | null;
-    getAllActiveSessions(): Record<string, MCPSession>;
-    closeSession(serverName: string): Promise<void>;
-    closeAllSessions(): Promise<void>;
+    /**
+     * Create a connector from server configuration (Node.js version)
+     * Supports all connector types including StdioConnector
+     */
+    protected createConnectorFromConfig(serverConfig: Record<string, any>): BaseConnector;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAiC;IAC1C,cAAc,EAAE,MAAM,EAAE,CAAK;gBAExB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;WAWnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;WAI7C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAI9C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKhE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhC,cAAc,IAAI,MAAM,EAAE;IAI1B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIlD,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIhC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ5B,aAAa,CACxB,UAAU,EAAE,MAAM,EAClB,cAAc,UAAO,GACpB,OAAO,CAAC,UAAU,CAAC;IAwBT,iBAAiB,CAC5B,cAAc,UAAO,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAc/B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAWjD,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAM5C,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB/C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhD;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;WAcnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;WAI7C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAIrD;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQzC;;;OAGG;IACH,SAAS,CAAC,yBAAyB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;CAGtF"}

package/dist/src/client.js

@@ -1,21 +1,28 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { BaseMCPClient } from './client/base.js';
 import { createConnectorFromConfig, loadConfigFile } from './config.js';
-import { logger } from './logging.js';
-import { MCPSession } from './session.js';
-export class MCPClient {
-    config = {};
-    sessions = {};
-    activeSessions = [];
+/**
+ * Node.js-specific MCPClient implementation
+ *
+ * Extends the base client with Node.js-specific features like:
+ * - File system operations (saveConfig)
+ * - Config file loading (fromConfigFile)
+ * - All connector types including StdioConnector
+ */
+export class MCPClient extends BaseMCPClient {
     constructor(config) {
         if (config) {
             if (typeof config === 'string') {
-                this.config = loadConfigFile(config);
+                super(loadConfigFile(config));
             }
             else {
-                this.config = config;
+                super(config);
             }
         }
+        else {
+            super();
+        }
     }
     static fromDict(cfg) {
         return new MCPClient(cfg);
@@ -23,25 +30,9 @@ export class MCPClient {
     static fromConfigFile(path) {
         return new MCPClient(loadConfigFile(path));
     }
-    addServer(name, serverConfig) {
-        this.config.mcpServers = this.config.mcpServers || {};
-        this.config.mcpServers[name] = serverConfig;
-    }
-    removeServer(name) {
-        if (this.config.mcpServers?.[name]) {
-            delete this.config.mcpServers[name];
-            this.activeSessions = this.activeSessions.filter(n => n !== name);
-        }
-    }
-    getServerNames() {
-        return Object.keys(this.config.mcpServers ?? {});
-    }
-    getServerConfig(name) {
-        return this.config.mcpServers?.[name];
-    }
-    getConfig() {
-        return this.config ?? {};
-    }
+    /**
+     * Save configuration to a file (Node.js only)
+     */
     saveConfig(filepath) {
         const dir = path.dirname(filepath);
         if (!fs.existsSync(dir)) {
@@ -49,85 +40,11 @@ export class MCPClient {
         }
         fs.writeFileSync(filepath, JSON.stringify(this.config, null, 2), 'utf-8');
     }
-    async createSession(serverName, autoInitialize = true) {
-        const servers = this.config.mcpServers ?? {};
-        if (Object.keys(servers).length === 0) {
-            logger.warn('No MCP servers defined in config');
-        }
-        if (!servers[serverName]) {
-            throw new Error(`Server '${serverName}' not found in config`);
-        }
-        const connector = createConnectorFromConfig(servers[serverName]);
-        const session = new MCPSession(connector);
-        if (autoInitialize) {
-            await session.initialize();
-        }
-        this.sessions[serverName] = session;
-        if (!this.activeSessions.includes(serverName)) {
-            this.activeSessions.push(serverName);
-        }
-        return session;
-    }
-    async createAllSessions(autoInitialize = true) {
-        const servers = this.config.mcpServers ?? {};
-        if (Object.keys(servers).length === 0) {
-            logger.warn('No MCP servers defined in config');
-        }
-        for (const name of Object.keys(servers)) {
-            await this.createSession(name, autoInitialize);
-        }
-        return this.sessions;
-    }
-    getSession(serverName) {
-        const session = this.sessions[serverName];
-        // if (!session) {
-        //   throw new Error(`No session exists for server '${serverName}'`)
-        // }
-        if (!session) {
-            return null;
-        }
-        return session;
-    }
-    getAllActiveSessions() {
-        return Object.fromEntries(this.activeSessions.map(n => [n, this.sessions[n]]));
-    }
-    async closeSession(serverName) {
-        const session = this.sessions[serverName];
-        if (!session) {
-            logger.warn(`No session exists for server ${serverName}, nothing to close`);
-            return;
-        }
-        try {
-            logger.debug(`Closing session for server ${serverName}`);
-            await session.disconnect();
-        }
-        catch (e) {
-            logger.error(`Error closing session for server '${serverName}': ${e}`);
-        }
-        finally {
-            delete this.sessions[serverName];
-            this.activeSessions = this.activeSessions.filter(n => n !== serverName);
-        }
-    }
-    async closeAllSessions() {
-        const serverNames = Object.keys(this.sessions);
-        const errors = [];
-        for (const serverName of serverNames) {
-            try {
-                logger.debug(`Closing session for server ${serverName}`);
-                await this.closeSession(serverName);
-            }
-            catch (e) {
-                const errorMsg = `Failed to close session for server '${serverName}': ${e}`;
-                logger.error(errorMsg);
-                errors.push(errorMsg);
-            }
-        }
-        if (errors.length) {
-            logger.error(`Encountered ${errors.length} errors while closing sessions`);
-        }
-        else {
-            logger.debug('All sessions closed successfully');
-        }
+    /**
+     * Create a connector from server configuration (Node.js version)
+     * Supports all connector types including StdioConnector
+     */
+    createConnectorFromConfig(serverConfig) {
+        return createConnectorFromConfig(serverConfig);
     }
 }

package/dist/src/logging.d.ts

@@ -28,7 +28,7 @@ export declare class Logger {
     private static currentFormat;
     static get(name?: string): WinstonLogger | SimpleConsoleLogger;
     private static getFormatter;
-    static configure(options?: LoggerOptions): void;
+    static configure(options?: LoggerOptions): Promise<void>;
     static setDebug(enabled: boolean | 0 | 1 | 2): void;
     static setFormat(format: 'minimal' | 'detailed' | 'emoji'): void;
 }

package/dist/src/logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAOtD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAEzF,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;CAC1C;AAsCD,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,IAAI,CAAQ;gBAER,IAAI,GAAE,MAA4B,EAAE,KAAK,GAAE,QAAiB;IAKxE,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,aAAa;IAKrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAE3B;CACF;AA4BD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA0D;IAClF,OAAO,CAAC,MAAM,CAAC,eAAe,CAA0C;IACxE,OAAO,CAAC,MAAM,CAAC,aAAa,CAA8C;WAE5D,GAAG,CAAC,IAAI,GAAE,MAA4B,GAAG,aAAa,GAAG,mBAAmB;IA4B1F,OAAO,CAAC,MAAM,CAAC,YAAY;WAab,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI;WAiD5C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI;WAyB5C,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI;CAIxE;AAWD,eAAO,MAAM,MAAM,qCAAe,CAAA"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAqBtD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAEzF,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;CAC1C;AAqCD,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,IAAI,CAAQ;gBAER,IAAI,GAAE,MAA4B,EAAE,KAAK,GAAE,QAAiB;IAKxE,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,aAAa;IAKrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAE3B;CACF;AA4BD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA0D;IAClF,OAAO,CAAC,MAAM,CAAC,eAAe,CAA0C;IACxE,OAAO,CAAC,MAAM,CAAC,aAAa,CAA8C;WAE5D,GAAG,CAAC,IAAI,GAAE,MAA4B,GAAG,aAAa,GAAG,mBAAmB;IA4B1F,OAAO,CAAC,MAAM,CAAC,YAAY;WAaP,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;WAqD3D,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI;WAyB5C,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI;CAIxE;AAWD,eAAO,MAAM,MAAM,qCAAe,CAAA"}