mcp-use 0.1.2 → 0.1.4

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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",
@@ -71,7 +71,6 @@
   "dependencies": {
     "@dmitryrechkin/json-schema-to-zod": "^1.0.1",
     "@langchain/anthropic": "^0.3.14",
-    "@langchain/community": "0.3.45",
     "@langchain/core": "0.3.58",
     "@langchain/openai": "^0.5.15",
     "@modelcontextprotocol/sdk": "1.12.1",