mcp-use 0.1.3 → 0.1.5

package/README.md

@@ -188,6 +188,13 @@ const agent = new MCPAgent({
 
 <table>
 <tr>
+    <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
+        <a href=https://github.com/pietrozullo>
+            <img src=https://avatars.githubusercontent.com/u/62951181?v=4 width="100;"  style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Pietro Zullo/>
+            <br />
+            <sub style="font-size:14px"><b>Pietro Zullo</b></sub>
+        </a>
+    </td>
     <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
         <a href=https://github.com/zandko>
             <img src=https://avatars.githubusercontent.com/u/37948383?v=4 width="100;"  style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Zane/>
@@ -196,10 +203,10 @@ const agent = new MCPAgent({
         </a>
     </td>
     <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
-        <a href=https://github.com/pietrozullo>
-            <img src=https://avatars.githubusercontent.com/u/62951181?v=4 width="100;"  style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Pietro Zullo/>
+        <a href=https://github.com/Pederzh>
+            <img src=https://avatars.githubusercontent.com/u/11487621?v=4 width="100;"  style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Luigi Pederzani/>
             <br />
-            <sub style="font-size:14px"><b>Pietro Zullo</b></sub>
+            <sub style="font-size:14px"><b>Luigi Pederzani</b></sub>
         </a>
     </td>
 </tr>

package/dist/examples/http_example.js

@@ -20,7 +20,7 @@ import { MCPAgent, MCPClient } from '../index.js';
 // Load environment variables from .env file
 config();
 async function main() {
-    const config = { mcpServers: { http: { url: 'https://hf.com/mcp' } } };
+    const config = { mcpServers: { http: { url: 'https://gitmcp.io/docs' } } };
     // Create MCPClient from config
     const client = MCPClient.fromDict(config);
     // Create LLM
@@ -28,8 +28,9 @@ async function main() {
     // Create agent with the client
     const agent = new MCPAgent({ llm, client, maxSteps: 30 });
     // Run the query
-    const result = await agent.run('Find the best restaurant in San Francisco USING GOOGLE SEARCH', 30);
+    const result = await agent.run('Which tools are available and what can they do?', 30);
     console.log(`\nResult: ${result}`);
+    await agent.close();
 }
 if (import.meta.url === `file://${process.argv[1]}`) {
     main().catch(console.error);

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAMzD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAGpE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAChC,aAAa,CAwBf"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAMzD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAGpE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAChC,aAAa,CA6Bf"}

package/dist/src/config.js

@@ -15,9 +15,13 @@ export function createConnectorFromConfig(serverConfig) {
         });
     }
     if ('url' in serverConfig) {
+        // HttpConnector automatically handles streamable HTTP with SSE fallback
+        const transport = serverConfig.transport || 'http';
         return new HttpConnector(serverConfig.url, {
             headers: serverConfig.headers,
-            authToken: serverConfig.auth_token,
+            authToken: serverConfig.auth_token || serverConfig.authToken,
+            // Only force SSE if explicitly requested
+            preferSse: serverConfig.preferSse || transport === 'sse',
         });
     }
     if ('ws_url' in serverConfig) {

package/dist/src/connectors/http.d.ts

@@ -9,6 +9,7 @@ export interface HttpConnectorOptions extends ConnectorInitOptions {
         name: string;
         version: string;
     };
+    preferSse?: boolean;
 }
 export declare class HttpConnector extends BaseConnector {
     private readonly baseUrl;
@@ -16,9 +17,17 @@ export declare class HttpConnector extends BaseConnector {
     private readonly timeout;
     private readonly sseReadTimeout;
     private readonly clientInfo;
+    private readonly preferSse;
+    private transportType;
     constructor(baseUrl: string, opts?: HttpConnectorOptions);
-    /** Establish connection to the MCP implementation via SSE. */
+    /** Establish connection to the MCP implementation via HTTP (streamable or SSE). */
     connect(): Promise<void>;
+    private connectWithStreamableHttp;
+    private connectWithSse;
     get publicIdentifier(): Record<string, string>;
+    /**
+     * Get the transport type being used (streamable-http or sse)
+     */
+    getTransportType(): 'streamable-http' | 'sse' | null;
 }
 //# sourceMappingURL=http.d.ts.map

package/dist/src/connectors/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connectors/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAIrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;gBAElD,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAc5D,8DAA8D;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC9B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK7C;CACF"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connectors/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAMrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,aAAa,CAAyC;gBAElD,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAe5D,mFAAmF;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAkEhB,yBAAyB;YAmCzB,cAAc;IA4B5B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7C;IAED;;OAEG;IACH,gBAAgB,IAAI,iBAAiB,GAAG,KAAK,GAAG,IAAI;CAGrD"}

package/dist/src/connectors/http.js

@@ -1,6 +1,8 @@
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPError } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import { logger } from '../logging.js';
 import { SseConnectionManager } from '../task_managers/sse.js';
+import { StreamableHttpConnectionManager } from '../task_managers/streamable_http.js';
 import { BaseConnector } from './base.js';
 export class HttpConnector extends BaseConnector {
     baseUrl;
@@ -8,6 +10,8 @@ export class HttpConnector extends BaseConnector {
     timeout;
     sseReadTimeout;
     clientInfo;
+    preferSse;
+    transportType = null;
     constructor(baseUrl, opts = {}) {
         super(opts);
         this.baseUrl = baseUrl.replace(/\/$/, '');
@@ -18,32 +22,114 @@ export class HttpConnector extends BaseConnector {
         this.timeout = opts.timeout ?? 5;
         this.sseReadTimeout = opts.sseReadTimeout ?? 60 * 5;
         this.clientInfo = opts.clientInfo ?? { name: 'http-connector', version: '1.0.0' };
+        this.preferSse = opts.preferSse ?? false;
     }
-    /** Establish connection to the MCP implementation via SSE. */
+    /** Establish connection to the MCP implementation via HTTP (streamable or SSE). */
     async connect() {
         if (this.connected) {
             logger.debug('Already connected to MCP implementation');
             return;
         }
-        logger.debug(`Connecting to MCP implementation via HTTP/SSE: ${this.baseUrl}`);
+        const baseUrl = this.baseUrl;
+        // If preferSse is set, skip directly to SSE
+        if (this.preferSse) {
+            logger.debug(`Connecting to MCP implementation via HTTP/SSE: ${baseUrl}`);
+            await this.connectWithSse(baseUrl);
+            return;
+        }
+        // Try streamable HTTP first, then fall back to SSE
+        logger.debug(`Connecting to MCP implementation via HTTP: ${baseUrl}`);
+        try {
+            // Try streamable HTTP transport first
+            logger.debug('Attempting streamable HTTP transport...');
+            await this.connectWithStreamableHttp(baseUrl);
+        }
+        catch (err) {
+            // Check if this is a 4xx error that indicates we should try SSE fallback
+            let fallbackReason = 'Unknown error';
+            if (err instanceof StreamableHTTPError) {
+                if (err.code === 404 || err.code === 405) {
+                    fallbackReason = `Server returned ${err.code} - server likely doesn't support streamable HTTP`;
+                    logger.debug(fallbackReason);
+                }
+                else {
+                    fallbackReason = `Server returned ${err.code}: ${err.message}`;
+                    logger.debug(fallbackReason);
+                }
+            }
+            else if (err instanceof Error) {
+                // Check for 404/405 in error message as fallback detection
+                const errorStr = err.toString();
+                if (errorStr.includes('405 Method Not Allowed') || errorStr.includes('404 Not Found')) {
+                    fallbackReason = 'Server doesn\'t support streamable HTTP (405/404)';
+                    logger.debug(fallbackReason);
+                }
+                else {
+                    fallbackReason = `Streamable HTTP failed: ${err.message}`;
+                    logger.debug(fallbackReason);
+                }
+            }
+            // Always try SSE fallback for maximum compatibility
+            logger.debug('Falling back to SSE transport...');
+            try {
+                await this.connectWithSse(baseUrl);
+            }
+            catch (sseErr) {
+                logger.error(`Failed to connect with both transports:`);
+                logger.error(`  Streamable HTTP: ${fallbackReason}`);
+                logger.error(`  SSE: ${sseErr}`);
+                await this.cleanupResources();
+                throw new Error('Could not connect to server with any available transport');
+            }
+        }
+    }
+    async connectWithStreamableHttp(baseUrl) {
         try {
-            // Build the SSE URL (root of server endpoint)
-            const sseUrl = this.baseUrl;
-            // Create and start the connection manager -> returns an SSE transport
-            this.connectionManager = new SseConnectionManager(sseUrl, {
+            // Create and start the streamable HTTP connection manager
+            this.connectionManager = new StreamableHttpConnectionManager(baseUrl, {
                 requestInit: {
                     headers: this.headers,
                 },
+                // Pass through timeout and other options
+                reconnectionOptions: {
+                    maxReconnectionDelay: 30000,
+                    initialReconnectionDelay: 1000,
+                    reconnectionDelayGrowFactor: 1.5,
+                    maxRetries: 2,
+                },
             });
             const transport = await this.connectionManager.start();
             // Create and connect the client
             this.client = new Client(this.clientInfo, this.opts.clientOptions);
             await this.client.connect(transport);
             this.connected = true;
-            logger.debug(`Successfully connected to MCP implementation via HTTP/SSE: ${this.baseUrl}`);
+            this.transportType = 'streamable-http';
+            logger.debug(`Successfully connected to MCP implementation via streamable HTTP: ${baseUrl}`);
         }
         catch (err) {
-            logger.error(`Failed to connect to MCP implementation via HTTP/SSE: ${err}`);
+            // Clean up partial resources before throwing
+            await this.cleanupResources();
+            throw err;
+        }
+    }
+    async connectWithSse(baseUrl) {
+        try {
+            // Create and start the SSE connection manager
+            this.connectionManager = new SseConnectionManager(baseUrl, {
+                requestInit: {
+                    headers: this.headers,
+                },
+            });
+            const transport = await this.connectionManager.start();
+            // Create and connect the client
+            this.client = new Client(this.clientInfo, this.opts.clientOptions);
+            await this.client.connect(transport);
+            this.connected = true;
+            this.transportType = 'sse';
+            logger.debug(`Successfully connected to MCP implementation via HTTP/SSE: ${baseUrl}`);
+        }
+        catch (err) {
+            // Clean up partial resources before throwing
             await this.cleanupResources();
             throw err;
         }
@@ -52,6 +138,13 @@ export class HttpConnector extends BaseConnector {
         return {
             type: 'http',
             url: this.baseUrl,
+            transport: this.transportType || 'unknown',
         };
     }
+    /**
+     * Get the transport type being used (streamable-http or sse)
+     */
+    getTransportType() {
+        return this.transportType;
+    }
 }

package/dist/src/task_managers/index.d.ts

@@ -1,5 +1,6 @@
 export { ConnectionManager } from './base.js';
 export { SseConnectionManager } from './sse.js';
 export { StdioConnectionManager } from './stdio.js';
+export { StreamableHttpConnectionManager } from './streamable_http.js';
 export { WebSocketConnectionManager } from './websocket.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/task_managers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/task_managers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/task_managers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/src/task_managers/index.js

@@ -1,4 +1,5 @@
 export { ConnectionManager } from './base.js';
 export { SseConnectionManager } from './sse.js';
 export { StdioConnectionManager } from './stdio.js';
+export { StreamableHttpConnectionManager } from './streamable_http.js';
 export { WebSocketConnectionManager } from './websocket.js';

package/dist/src/task_managers/streamable_http.d.ts

@@ -0,0 +1,29 @@
+import type { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { ConnectionManager } from './base.js';
+export declare class StreamableHttpConnectionManager extends ConnectionManager<StreamableHTTPClientTransport> {
+    private readonly url;
+    private readonly opts?;
+    private _transport;
+    /**
+     * Create a Streamable HTTP connection manager.
+     *
+     * @param url  The HTTP endpoint URL.
+     * @param opts Optional transport options (auth, headers, etc.).
+     */
+    constructor(url: string | URL, opts?: StreamableHTTPClientTransportOptions);
+    /**
+     * Spawn a new `StreamableHTTPClientTransport` and return it.
+     * The Client.connect() method will handle starting the transport.
+     */
+    protected establishConnection(): Promise<StreamableHTTPClientTransport>;
+    /**
+     * Close the underlying transport and clean up resources.
+     */
+    protected closeConnection(_connection: StreamableHTTPClientTransport): Promise<void>;
+    /**
+     * Get the session ID from the transport if available.
+     */
+    get sessionId(): string | undefined;
+}
+//# sourceMappingURL=streamable_http.d.ts.map

package/dist/src/task_managers/streamable_http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable_http.d.ts","sourceRoot":"","sources":["../../../src/task_managers/streamable_http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,oDAAoD,CAAA;AAC9G,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAA;AAElG,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE7C,qBAAa,+BAAgC,SAAQ,iBAAiB,CAAC,6BAA6B,CAAC;IACnG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAsC;IAC5D,OAAO,CAAC,UAAU,CAA6C;IAE/D;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,oCAAoC;IAM1E;;;OAGG;cACa,mBAAmB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAO7E;;OAEG;cACa,eAAe,CAAC,WAAW,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1F;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF"}

package/dist/src/task_managers/streamable_http.js

@@ -0,0 +1,50 @@
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { logger } from '../logging.js';
+import { ConnectionManager } from './base.js';
+export class StreamableHttpConnectionManager extends ConnectionManager {
+    url;
+    opts;
+    _transport = null;
+    /**
+     * Create a Streamable HTTP connection manager.
+     *
+     * @param url  The HTTP endpoint URL.
+     * @param opts Optional transport options (auth, headers, etc.).
+     */
+    constructor(url, opts) {
+        super();
+        this.url = typeof url === 'string' ? new URL(url) : url;
+        this.opts = opts;
+    }
+    /**
+     * Spawn a new `StreamableHTTPClientTransport` and return it.
+     * The Client.connect() method will handle starting the transport.
+     */
+    async establishConnection() {
+        this._transport = new StreamableHTTPClientTransport(this.url, this.opts);
+        logger.debug(`${this.constructor.name} created successfully`);
+        return this._transport;
+    }
+    /**
+     * Close the underlying transport and clean up resources.
+     */
+    async closeConnection(_connection) {
+        if (this._transport) {
+            try {
+                await this._transport.close();
+            }
+            catch (e) {
+                logger.warn(`Error closing Streamable HTTP transport: ${e}`);
+            }
+            finally {
+                this._transport = null;
+            }
+        }
+    }
+    /**
+     * Get the session ID from the transport if available.
+     */
+    get sessionId() {
+        return this._transport?.sessionId;
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AA0EjF,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAEhD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8D;IAC3F,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA2D;IACjG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoD;IACpF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8C;IAChF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IAEpD,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,OAAO,CAAuB;IAEtC,OAAO;IAwCP,MAAM,CAAC,WAAW,IAAI,SAAS;IAO/B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB,IAAI,MAAM,IAAI,MAAM,CAgCnB;IAEK,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CjD,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDrE,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1E,KAAK,IAAI,IAAI;IAkBb,QAAQ,IAAI,IAAI;CAiBjB"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAiHjF,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAEhD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8D;IAC3F,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA2D;IACjG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoD;IACpF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8C;IAChF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IAEpD,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,OAAO,CAAuB;IAEtC,OAAO;IAiDP,MAAM,CAAC,WAAW,IAAI,SAAS;IAO/B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB,IAAI,MAAM,IAAI,MAAM,CAsCnB;IAEK,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CjD,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DrE,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1E,KAAK,IAAI,IAAI;IAkBb,QAAQ,IAAI,IAAI;CAiBjB"}

package/dist/src/telemetry/telemetry.js

@@ -6,6 +6,31 @@ import { v4 as uuidv4 } from 'uuid';
 import { logger } from '../logging.js';
 import { MCPAgentExecutionEvent } from './events.js';
 import { getPackageVersion } from './utils.js';
+// Environment detection function
+function isNodeJSEnvironment() {
+    try {
+        // Check for Cloudflare Workers specifically
+        if (typeof navigator !== 'undefined' && navigator.userAgent?.includes('Cloudflare-Workers')) {
+            return false;
+        }
+        // Check for other edge runtime indicators
+        if (typeof globalThis.EdgeRuntime !== 'undefined' || typeof globalThis.Deno !== 'undefined') {
+            return false;
+        }
+        // Check for Node.js specific globals that are not available in edge environments
+        const hasNodeGlobals = (typeof process !== 'undefined'
+            && typeof process.platform !== 'undefined'
+            && typeof __dirname !== 'undefined');
+        // Check for Node.js modules
+        const hasNodeModules = (typeof fs !== 'undefined'
+            && typeof os !== 'undefined'
+            && typeof fs.existsSync === 'function');
+        return hasNodeGlobals && hasNodeModules;
+    }
+    catch {
+        return false;
+    }
+}
 // Simple Scarf event logger implementation
 class ScarfEventLogger {
     endpoint;
@@ -38,6 +63,10 @@ class ScarfEventLogger {
     }
 }
 function getCacheHome() {
+    // Return a safe fallback for non-Node.js environments
+    if (!isNodeJSEnvironment()) {
+        return '/tmp/mcp_use_cache';
+    }
     // XDG_CACHE_HOME for Linux and manually set envs
     const envVar = process.env.XDG_CACHE_HOME;
     if (envVar && path.isAbsolute(envVar)) {
@@ -74,13 +103,21 @@ export class Telemetry {
     _scarfClient = null;
     _source = 'typescript';
     constructor() {
-        const telemetryDisabled = process.env.MCP_USE_ANONYMIZED_TELEMETRY?.toLowerCase() === 'false';
+        // Check if we're in a Node.js environment first
+        const isNodeJS = isNodeJSEnvironment();
+        // Safely access environment variables
+        const telemetryDisabled = (typeof process !== 'undefined' && process.env?.MCP_USE_ANONYMIZED_TELEMETRY?.toLowerCase() === 'false') || false;
         // Check for source from environment variable, default to 'typescript'
-        this._source = process.env.MCP_USE_TELEMETRY_SOURCE || 'typescript';
+        this._source = (typeof process !== 'undefined' && process.env?.MCP_USE_TELEMETRY_SOURCE) || 'typescript';
         if (telemetryDisabled) {
             this._posthogClient = null;
             this._scarfClient = null;
-            logger.debug('Telemetry disabled');
+            logger.debug('Telemetry disabled via environment variable');
+        }
+        else if (!isNodeJS) {
+            this._posthogClient = null;
+            this._scarfClient = null;
+            logger.debug('Telemetry disabled - non-Node.js environment detected (e.g., Cloudflare Workers)');
         }
         else {
             logger.info('Anonymized telemetry enabled. Set MCP_USE_ANONYMIZED_TELEMETRY=false to disable.');
@@ -130,6 +167,11 @@ export class Telemetry {
         if (this._currUserId) {
             return this._currUserId;
         }
+        // If we're not in a Node.js environment, just return a static user ID
+        if (!isNodeJSEnvironment()) {
+            this._currUserId = this.UNKNOWN_USER_ID;
+            return this._currUserId;
+        }
         try {
             const isFirstTime = !fs.existsSync(this.USER_ID_PATH);
             if (isFirstTime) {
@@ -198,6 +240,10 @@ export class Telemetry {
         if (!this._scarfClient) {
             return;
         }
+        // Skip tracking in non-Node.js environments
+        if (!isNodeJSEnvironment()) {
+            return;
+        }
         try {
             const currentVersion = getPackageVersion();
             let shouldTrack = false;

package/dist/src/telemetry/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/telemetry/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAI7E,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAG/D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAgB3D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/telemetry/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAI7E,wBAAgB,iBAAiB,IAAI,MAAM,CAc1C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAG/D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAgB3D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzE"}

package/dist/src/telemetry/utils.js

@@ -2,6 +2,10 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 export function getPackageVersion() {
     try {
+        // Check if we're in a Node.js environment with file system access
+        if (typeof __dirname === 'undefined' || typeof fs === 'undefined') {
+            return 'unknown';
+        }
         const packagePath = path.join(__dirname, '../../package.json');
         const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));
         return packageJson.version || 'unknown';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "packageManager": "pnpm@10.6.1",
   "description": "A utility library for integrating Model Context Protocol (MCP) with LangChain, Zod, and related tools. Provides helpers for schema conversion, event streaming, and SDK usage.",
   "author": "Zane",