mcp-use 0.0.6 → 0.0.8

package/README.md

@@ -1,10 +1,31 @@
+<div align="center" style="margin: 0 auto; max-width: 80%;">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./static/logo_white.svg">
+    <source media="(prefers-color-scheme: light)" srcset="./static/logo_black.svg">
+    <img alt="mcp use logo" src="./static/logo_white.svg" width="80%" style="margin: 20px auto;">
+  </picture>
+</div>
+
 <h1 align="center">Unified MCP Client Library</h1>
 
-[![](https://img.shields.io/npm/dw/mcp-use.svg)](https://www.npmjs.com/package/mcp-use)
-[![npm version](https://img.shields.io/npm/v/mcp-use.svg)](https://www.npmjs.com/package/mcp-use)
-[![License](https://img.shields.io/github/license/zandko/mcp-use)](https://github.com/zandko/mcp-use/blob/main/LICENSE)
-[![Code style: ESLint](https://img.shields.io/badge/code%20style-eslint-4B32C3.svg)](https://eslint.org)
-[![GitHub stars](https://img.shields.io/github/stars/zandko/mcp-use?style=social)](https://github.com/zandko/mcp-use/stargazers)
+<p align="center">
+    <a href="https://www.npmjs.com/package/mcp-use" alt="NPM Downloads">
+        <img src="https://img.shields.io/npm/dw/mcp-use.svg"/></a>
+    <a href="https://www.npmjs.com/package/mcp-use" alt="NPM Version">
+        <img src="https://img.shields.io/npm/v/mcp-use.svg"/></a>
+    <a href="https://docs.mcp-use.io" alt="Documentation">
+        <img src="https://img.shields.io/badge/docs-mcp--use.io-blue" /></a>
+    <a href="https://mcp-use.io" alt="Website">
+        <img src="https://img.shields.io/badge/website-mcp--use.io-blue" /></a>
+    <a href="https://github.com/mcp-use/mcp-use-ts/blob/main/LICENSE" alt="License">
+        <img src="https://img.shields.io/github/license/mcp-use/mcp-use-ts" /></a>
+    <a href="https://eslint.org" alt="Code style: ESLint">
+        <img src="https://img.shields.io/badge/code%20style-eslint-4B32C3.svg" /></a>
+    <a href="https://github.com/mcp-use/mcp-use-ts/stargazers" alt="GitHub stars">
+        <img src="https://img.shields.io/github/stars/mcp-use/mcp-use-ts?style=social" /></a>
+    <a href="https://discord.gg/XkNkSkMz3V" alt="Discord">
+        <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" /></a>
+</p>
 
 🌐 **MCP Client** is the open-source way to connect **any LLM to any MCP server** in TypeScript/Node.js, letting you build custom agents with tool access without closed-source dependencies.
 
@@ -99,6 +120,7 @@ Load it:
 
 ```ts
 import { MCPClient } from 'mcp-use'
+
 const client = MCPClient.fromConfigFile('./mcp-config.json')
 ```
 
@@ -141,6 +163,13 @@ const agent = new MCPAgent({
             <sub style="font-size:14px"><b>Zane</b></sub>
         </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/>
+            <br />
+            <sub style="font-size:14px"><b>Pietro Zullo</b></sub>
+        </a>
+    </td>
 </tr>
 </table>
 

package/dist/index.d.ts

@@ -7,5 +7,7 @@ import { StdioConnector } from './src/connectors/stdio.js';
 import { WebSocketConnector } from './src/connectors/websocket.js';
 import { Logger, logger } from './src/logging.js';
 import { MCPSession } from './src/session.js';
+export { BaseAdapter, LangChainAdapter } from './src/adapters/index.js';
+export { ServerManager } from './src/managers/server_manager.js';
 export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, StdioConnector, WebSocketConnector };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAEhE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/index.js

@@ -7,4 +7,6 @@ import { StdioConnector } from './src/connectors/stdio.js';
 import { WebSocketConnector } from './src/connectors/websocket.js';
 import { Logger, logger } from './src/logging.js';
 import { MCPSession } from './src/session.js';
+export { BaseAdapter, LangChainAdapter } from './src/adapters/index.js';
+export { ServerManager } from './src/managers/server_manager.js';
 export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, StdioConnector, WebSocketConnector };

package/dist/src/adapters/langchain_adapter.js

@@ -80,7 +80,7 @@ export class LangChainAdapter extends BaseAdapter {
                     return parseMcpToolResult(result);
                 }
                 catch (err) {
-                    logger.error(`Error executing MCP tool: ${err}`);
+                    logger.error(`Error executing MCP tool: ${err.message}`);
                     return `Error executing MCP tool: ${String(err)}`;
                 }
             },

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

@@ -1,4 +1,3 @@
 export { BaseAgent } from './base.js';
 export { MCPAgent } from './mcp_agent.js';
-export { ServerManager } from './server_manager.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/src/agents/index.js

@@ -1,3 +1,2 @@
 export { BaseAgent } from './base.js';
 export { MCPAgent } from './mcp_agent.js';
-export { ServerManager } from './server_manager.js';

package/dist/src/agents/mcp_agent.d.ts

@@ -2,7 +2,7 @@ import type { BaseLanguageModelInterface } from '@langchain/core/language_models
 import type { BaseMessage } from '@langchain/core/messages';
 import type { MCPClient } from '../client.js';
 import type { BaseConnector } from '../connectors/base.js';
-import type { ServerManager } from './server_manager.js';
+import type { ServerManager } from '../managers/server_manager.js';
 import { SystemMessage } from '@langchain/core/messages';
 import { LangChainAdapter } from '../adapters/langchain_adapter.js';
 export declare class MCPAgent {

package/dist/src/agents/mcp_agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp_agent.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp_agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAqB,MAAM,sCAAsC,CAAA;AACzG,OAAO,KAAK,EACV,WAAW,EACZ,MAAM,0BAA0B,CAAA;AAGjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAGL,aAAa,EACd,MAAM,0BAA0B,CAAA;AAUjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAKnE,qBAAa,QAAQ;IACnB,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,MAAM,CAAC,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,4BAA4B,CAAC,CAAe;IACpD,OAAO,CAAC,sBAAsB,CAAC,CAAe;IAE9C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,EAAE;QACnB,GAAG,EAAE,0BAA0B,CAAA;QAC/B,MAAM,CAAC,EAAE,SAAS,CAAA;QAClB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACpC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACtC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAA;QAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,gBAAgB,CAAA;QAC1B,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAA;KAC5D;IAkCY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YA8D1B,4BAA4B;IAuB1C,OAAO,CAAC,WAAW;IAyBZ,sBAAsB,IAAI,WAAW,EAAE;IAIvC,wBAAwB,IAAI,IAAI;IAIvC,OAAO,CAAC,YAAY;IAKb,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAavC,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI;IAQnD,kBAAkB,IAAI,MAAM,EAAE;IAIxB,GAAG,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,UAAO,EACtB,eAAe,CAAC,EAAE,WAAW,EAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;IAyJL,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBpC"}
+{"version":3,"file":"mcp_agent.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp_agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAqB,MAAM,sCAAsC,CAAA;AACzG,OAAO,KAAK,EACV,WAAW,EACZ,MAAM,0BAA0B,CAAA;AAGjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAGL,aAAa,EACd,MAAM,0BAA0B,CAAA;AAUjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAKnE,qBAAa,QAAQ;IACnB,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,MAAM,CAAC,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,4BAA4B,CAAC,CAAe;IACpD,OAAO,CAAC,sBAAsB,CAAC,CAAe;IAE9C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,EAAE;QACnB,GAAG,EAAE,0BAA0B,CAAA;QAC/B,MAAM,CAAC,EAAE,SAAS,CAAA;QAClB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACpC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACtC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAA;QAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,gBAAgB,CAAA;QAC1B,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAA;KAC5D;IAkCY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YA8D1B,4BAA4B;IAuB1C,OAAO,CAAC,WAAW;IAyBZ,sBAAsB,IAAI,WAAW,EAAE;IAIvC,wBAAwB,IAAI,IAAI;IAIvC,OAAO,CAAC,YAAY;IAKb,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAavC,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI;IAQnD,kBAAkB,IAAI,MAAM,EAAE;IAIxB,GAAG,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,UAAO,EACtB,eAAe,CAAC,EAAE,WAAW,EAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;IAyJL,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBpC"}

package/dist/src/agents/mcp_agent.js

@@ -63,7 +63,7 @@ export class MCPAgent {
         if (this.useServerManager && this.serverManager) {
             await this.serverManager.initialize();
             // Get server management tools
-            const managementTools = await this.serverManager.getServerManagementTools();
+            const managementTools = this.serverManager.tools;
             this.tools = managementTools;
             logger.info(`🔧 Server manager mode active with ${managementTools.length} management tools`);
             // Create the system message based on available tools
@@ -209,7 +209,7 @@ export class MCPAgent {
             logger.info(`🏁 Starting agent execution with max_steps=${steps}`);
             for (let stepNum = 0; stepNum < steps; stepNum++) {
                 if (this.useServerManager && this.serverManager) {
-                    const currentTools = await this.serverManager.getAllTools();
+                    const currentTools = this.serverManager.tools;
                     const currentToolNames = new Set(currentTools.map(t => t.name));
                     const existingToolNames = new Set(this.tools.map(t => t.name));
                     const changed = currentTools.length !== this.tools.length
@@ -223,7 +223,7 @@ export class MCPAgent {
                         nameToToolMap = Object.fromEntries(this.tools.map(t => [t.name, t]));
                     }
                 }
-                logger.info(`🔍 Step ${stepNum + 1}/${steps}`);
+                logger.info(`👣 Step ${stepNum + 1}/${steps}`);
                 try {
                     logger.debug('Starting agent step execution');
                     const nextStepOutput = await this.agentExecutor._takeNextStep(nameToToolMap, inputs, intermediateSteps);

package/dist/src/client.d.ts

@@ -12,7 +12,7 @@ export declare class MCPClient {
     saveConfig(filepath: string): void;
     createSession(serverName: string, autoInitialize?: boolean): Promise<MCPSession>;
     createAllSessions(autoInitialize?: boolean): Promise<Record<string, MCPSession>>;
-    getSession(serverName: string): MCPSession;
+    getSession(serverName: string): MCPSession | null;
     getAllActiveSessions(): Record<string, MCPSession>;
     closeSession(serverName: string): Promise<void>;
     closeAllSessions(): Promise<void>;

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,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;IAQ1C,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":"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,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"}

package/dist/src/client.js

@@ -46,7 +46,7 @@ export class MCPClient {
     async createSession(serverName, autoInitialize = true) {
         const servers = this.config.mcpServers ?? {};
         if (Object.keys(servers).length === 0) {
-            throw new Error('No MCP servers defined in config');
+            logger.warn('No MCP servers defined in config');
         }
         if (!servers[serverName]) {
             throw new Error(`Server '${serverName}' not found in config`);
@@ -65,7 +65,7 @@ export class MCPClient {
     async createAllSessions(autoInitialize = true) {
         const servers = this.config.mcpServers ?? {};
         if (Object.keys(servers).length === 0) {
-            throw new Error('No MCP servers defined in config');
+            logger.warn('No MCP servers defined in config');
         }
         for (const name of Object.keys(servers)) {
             await this.createSession(name, autoInitialize);
@@ -74,8 +74,11 @@ export class MCPClient {
     }
     getSession(serverName) {
         const session = this.sessions[serverName];
+        // if (!session) {
+        //   throw new Error(`No session exists for server '${serverName}'`)
+        // }
         if (!session) {
-            throw new Error(`No session exists for server '${serverName}'`);
+            return null;
         }
         return session;
     }

package/dist/src/logging.d.ts

@@ -1,9 +1,20 @@
 import type { Logger as WinstonLogger } from 'winston';
+export type LogLevel = 'error' | 'warn' | 'info' | 'http' | 'verbose' | 'debug' | 'silly';
+interface LoggerOptions {
+    level?: LogLevel;
+    console?: boolean;
+    file?: string;
+    format?: 'minimal' | 'detailed' | 'emoji';
+}
 export declare class Logger {
-    private static loggers;
-    static getLogger(name?: string): WinstonLogger;
-    static configure(level?: string, toConsole?: boolean, toFile?: string): void;
-    static setDebug(debugLevel?: number): void;
+    private static instances;
+    private static currentFormat;
+    static get(name?: string): WinstonLogger;
+    private static getFormatter;
+    static configure(options?: LoggerOptions): void;
+    static setDebug(enabled: boolean | 0 | 1 | 2): void;
+    static setFormat(format: 'minimal' | 'detailed' | 'emoji'): void;
 }
 export declare const logger: WinstonLogger;
+export {};
 //# sourceMappingURL=logging.d.ts.map

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;AAqBtD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAoC;WAE5C,SAAS,CAAC,IAAI,GAAE,MAAkB,GAAG,aAAa;WAelD,SAAS,CACrB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,GAAE,OAAc,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;WA0BO,QAAQ,CAAC,UAAU,GAAE,MAAU,GAAG,IAAI;CAarD;AAID,eAAO,MAAM,MAAM,eAAqB,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;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;AA2BD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoC;IAC5D,OAAO,CAAC,MAAM,CAAC,aAAa,CAA8C;WAE5D,GAAG,CAAC,IAAI,GAAE,MAA4B,GAAG,aAAa;IAkBpE,OAAO,CAAC,MAAM,CAAC,YAAY;WAab,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI;WAoC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI;WAc5C,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI;CAIxE;AAGD,eAAO,MAAM,MAAM,eAAe,CAAA"}

package/dist/src/logging.js

@@ -1,59 +1,92 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { createLogger, format, transports } from 'winston';
-const { combine, timestamp, label, printf } = format;
-let MCP_USE_DEBUG = 0;
-const debugEnv = process.env.DEBUG?.toLowerCase();
-if (debugEnv === '2') {
-    MCP_USE_DEBUG = 2;
-}
-else if (debugEnv === '1') {
-    MCP_USE_DEBUG = 1;
+const { combine, timestamp, label, printf, colorize, splat } = format;
+const DEFAULT_LOGGER_NAME = 'mcp-use';
+function resolveLevel(env) {
+    switch (env?.trim()) {
+        case '2':
+            return 'debug';
+        case '1':
+            return 'info';
+        default:
+            return 'warn';
+    }
 }
-const defaultFormat = printf(({ level, message, label, timestamp }) => `${timestamp} [${label}] ${level.toUpperCase()}: ${message}`);
+const minimalFormatter = printf(({ level, message, label, timestamp }) => {
+    return `${timestamp} [${label}] ${level}: ${message}`;
+});
+const detailedFormatter = printf(({ level, message, label, timestamp }) => {
+    return `${timestamp} [${label}] ${level.toUpperCase()}: ${message}`;
+});
+const emojiFormatter = printf(({ level, message, label, timestamp }) => {
+    return `${timestamp} [${label}] ${level.toUpperCase()}: ${message}`;
+});
 export class Logger {
-    static loggers = {};
-    static getLogger(name = 'mcp_use') {
-        if (!this.loggers[name]) {
-            this.loggers[name] = createLogger({
-                level: 'warn',
-                format: combine(label({ label: name }), timestamp(), defaultFormat),
+    static instances = {};
+    static currentFormat = 'minimal';
+    static get(name = DEFAULT_LOGGER_NAME) {
+        if (!this.instances[name]) {
+            this.instances[name] = createLogger({
+                level: resolveLevel(process.env.DEBUG),
+                format: combine(colorize(), splat(), label({ label: name }), timestamp({ format: 'HH:mm:ss' }), this.getFormatter()),
                 transports: [],
             });
         }
-        return this.loggers[name];
+        return this.instances[name];
     }
-    static configure(level, toConsole = true, toFile) {
-        const root = this.getLogger();
-        if (!level) {
-            level
-                = MCP_USE_DEBUG === 2
-                    ? 'debug'
-                    : MCP_USE_DEBUG === 1 ? 'info' : 'warn';
+    static getFormatter() {
+        switch (this.currentFormat) {
+            case 'minimal':
+                return minimalFormatter;
+            case 'detailed':
+                return detailedFormatter;
+            case 'emoji':
+                return emojiFormatter;
+            default:
+                return minimalFormatter;
         }
-        root.level = level;
+    }
+    static configure(options = {}) {
+        const { level, console = true, file, format = 'minimal' } = options;
+        const resolvedLevel = level ?? resolveLevel(process.env.DEBUG);
+        this.currentFormat = format;
+        const root = this.get();
+        root.level = resolvedLevel;
         root.clear();
-        if (toConsole) {
+        if (console) {
             root.add(new transports.Console());
         }
-        if (toFile) {
-            const dir = path.dirname(toFile);
-            if (dir && !fs.existsSync(dir)) {
+        if (file) {
+            const dir = path.dirname(path.resolve(file));
+            if (!fs.existsSync(dir)) {
                 fs.mkdirSync(dir, { recursive: true });
             }
-            root.add(new transports.File({ filename: toFile }));
+            root.add(new transports.File({ filename: file }));
         }
+        // Update all existing loggers with new format
+        Object.values(this.instances).forEach((logger) => {
+            logger.level = resolvedLevel;
+            logger.format = combine(colorize(), splat(), label({ label: DEFAULT_LOGGER_NAME }), timestamp({ format: 'HH:mm:ss' }), this.getFormatter());
+        });
     }
-    static setDebug(debugLevel = 2) {
-        MCP_USE_DEBUG = debugLevel;
-        process.env.LANGCHAIN_VERBOSE = debugLevel >= 1 ? 'true' : 'false';
-        const newLevel = debugLevel === 2
-            ? 'debug'
-            : debugLevel === 1 ? 'info' : 'warn';
-        Object.values(this.loggers).forEach((log) => {
-            log.level = newLevel;
+    static setDebug(enabled) {
+        let level;
+        if (enabled === 2 || enabled === true)
+            level = 'debug';
+        else if (enabled === 1)
+            level = 'info';
+        else
+            level = 'warn';
+        Object.values(this.instances).forEach((logger) => {
+            logger.level = level;
         });
+        process.env.DEBUG = enabled ? (enabled === true ? '2' : String(enabled)) : '0';
+    }
+    static setFormat(format) {
+        this.currentFormat = format;
+        this.configure({ format });
     }
 }
 Logger.configure();
-export const logger = Logger.getLogger();
+export const logger = Logger.get();

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

@@ -0,0 +1,3 @@
+export * from './server_manager.js';
+export * from './tools/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/managers/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA"}

package/dist/src/managers/index.js

@@ -0,0 +1,2 @@
+export * from './server_manager.js';
+export * from './tools/index.js';

package/dist/src/managers/server_manager.d.ts

@@ -0,0 +1,15 @@
+import type { StructuredToolInterface } from '@langchain/core/tools';
+import type { LangChainAdapter } from '../adapters/langchain_adapter.js';
+import type { MCPClient } from '../client.js';
+export declare class ServerManager {
+    readonly initializedServers: Record<string, boolean>;
+    readonly serverTools: Record<string, StructuredToolInterface[]>;
+    readonly client: MCPClient;
+    readonly adapter: LangChainAdapter;
+    activeServer: string | null;
+    constructor(client: MCPClient, adapter: LangChainAdapter);
+    initialize(): void;
+    prefetchServerTools(): Promise<void>;
+    get tools(): StructuredToolInterface[];
+}
+//# sourceMappingURL=server_manager.d.ts.map

package/dist/src/managers/server_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../../src/managers/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAU7C,qBAAa,aAAa;IACxB,SAAgB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAK;IAChE,SAAgB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAK;IAE3E,SAAgB,MAAM,EAAE,SAAS,CAAA;IACjC,SAAgB,OAAO,EAAE,gBAAgB,CAAA;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAO;gBAE7B,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB;IAKxD,UAAU,IAAI,IAAI;IAOZ,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD1C,IAAI,KAAK,IAAI,uBAAuB,EAAE,CAOrC;CACF"}

package/dist/src/managers/server_manager.js

@@ -0,0 +1,72 @@
+import { isEqual } from 'lodash-es';
+import { logger } from '../logging.js';
+import { AcquireActiveMCPServerTool } from './tools/acquire_active_mcp_server.js';
+import { ConnectMCPServerTool } from './tools/connect_mcp_server.js';
+import { ListMCPServersTool } from './tools/list_mcp_servers.js';
+import { ReleaseMCPServerConnectionTool } from './tools/release_mcp_server_connection.js';
+export class ServerManager {
+    initializedServers = {};
+    serverTools = {};
+    client;
+    adapter;
+    activeServer = null;
+    constructor(client, adapter) {
+        this.client = client;
+        this.adapter = adapter;
+    }
+    initialize() {
+        const serverNames = this.client.getServerNames?.();
+        if (serverNames.length === 0) {
+            logger.warning('No MCP servers defined in client configuration');
+        }
+    }
+    async prefetchServerTools() {
+        const servers = this.client.getServerNames();
+        for (const serverName of servers) {
+            try {
+                let session = null;
+                session = this.client.getSession(serverName);
+                logger.debug(`Using existing session for server '${serverName}' to prefetch tools.`);
+                if (!session) {
+                    session = await this.client.createSession(serverName).catch((createSessionError) => {
+                        logger.warn(`Could not create session for '${serverName}' during prefetch: ${createSessionError}`);
+                        return null;
+                    });
+                    logger.debug(`Temporarily created session for '${serverName}' to prefetch tools.`);
+                }
+                if (session) {
+                    const connector = session.connector;
+                    let tools = [];
+                    try {
+                        tools = await this.adapter.createToolsFromConnectors([connector]);
+                    }
+                    catch (toolFetchError) {
+                        logger.error(`Failed to create tools from connector for server '${serverName}': ${toolFetchError}`);
+                        continue;
+                    }
+                    const cachedTools = this.serverTools[serverName];
+                    const toolsChanged = !cachedTools || !isEqual(cachedTools, tools);
+                    if (toolsChanged) {
+                        this.serverTools[serverName] = tools;
+                        this.initializedServers[serverName] = true;
+                        logger.debug(`Prefetched ${tools.length} tools for server '${serverName}'.`);
+                    }
+                    else {
+                        logger.debug(`Tools for server '${serverName}' unchanged, using cached version.`);
+                    }
+                }
+            }
+            catch (outerError) {
+                logger.error(`Error prefetching tools for server '${serverName}': ${outerError}`);
+            }
+        }
+    }
+    get tools() {
+        return [
+            new ListMCPServersTool(this),
+            new ConnectMCPServerTool(this),
+            new AcquireActiveMCPServerTool(this),
+            new ReleaseMCPServerConnectionTool(this),
+        ];
+    }
+}

package/dist/src/managers/tools/acquire_active_mcp_server.d.ts

@@ -0,0 +1,13 @@
+import type { ServerManager } from '../server_manager.js';
+import { z } from 'zod';
+import { MCPServerTool } from './base.js';
+declare const PresentActiveServerSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare class AcquireActiveMCPServerTool extends MCPServerTool<typeof PresentActiveServerSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    constructor(manager: ServerManager);
+    _call(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=acquire_active_mcp_server.d.ts.map

package/dist/src/managers/tools/acquire_active_mcp_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire_active_mcp_server.d.ts","sourceRoot":"","sources":["../../../../src/managers/tools/acquire_active_mcp_server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,QAAA,MAAM,yBAAyB,gDAAe,CAAA;AAE9C,qBAAa,0BAA2B,SAAQ,aAAa,CAAC,OAAO,yBAAyB,CAAC;IACpF,IAAI,SAA0B;IAC9B,WAAW,SAAiE;IAC5E,MAAM,iDAA4B;gBAE/B,OAAO,EAAE,aAAa;IAI5B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAO/B"}

package/dist/src/managers/tools/acquire_active_mcp_server.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { MCPServerTool } from './base.js';
+const PresentActiveServerSchema = z.object({});
+export class AcquireActiveMCPServerTool extends MCPServerTool {
+    name = 'get_active_mcp_server';
+    description = 'Get the currently active MCP (Model Context Protocol) server';
+    schema = PresentActiveServerSchema;
+    constructor(manager) {
+        super(manager);
+    }
+    async _call() {
+        if (!this.manager.activeServer) {
+            return `No MCP server is currently active. Use connect_to_mcp_server to connect to a server.`;
+        }
+        return `Currently active MCP server: ${this.manager.activeServer}`;
+    }
+}

package/dist/src/managers/tools/base.d.ts

@@ -0,0 +1,24 @@
+import type { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
+import type { ToolParams, ToolRunnableConfig, ToolSchemaBase } from '@langchain/core/tools';
+import type { JSONSchema } from '@langchain/core/utils/json_schema';
+import type z from 'zod';
+import type { ServerManager } from '../server_manager.js';
+import { StructuredTool } from '@langchain/core/tools';
+export type ToolOutputT = any;
+export type SchemaOutputT<T extends ToolSchemaBase> = T extends z.ZodSchema ? z.output<T> : T extends JSONSchema ? unknown : never;
+export interface MCPServerToolOptions extends ToolParams {
+    name?: string;
+    description?: string;
+    returnDirect?: boolean;
+    sandboxId?: string;
+}
+export declare class MCPServerTool<SchemaT extends ToolSchemaBase> extends StructuredTool<SchemaT, SchemaOutputT<SchemaT>> {
+    name: string;
+    description: string;
+    schema: SchemaT;
+    private readonly _manager;
+    constructor(manager: ServerManager);
+    protected _call(_arg: SchemaOutputT<SchemaT>, _runManager?: CallbackManagerForToolRun, _parentConfig?: ToolRunnableConfig): Promise<ToolOutputT>;
+    get manager(): ServerManager;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/managers/tools/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/managers/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,GAAG,CAAA;AAC7B,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,GACvE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACX,CAAC,SAAS,UAAU,GAClB,OAAO,GACP,KAAK,CAAA;AAEX,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,aAAa,CAAC,OAAO,SAAS,cAAc,CAAE,SAAQ,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACvG,IAAI,EAAE,MAAM,CAAoB;IAChC,WAAW,EAAE,MAAM,CAAyC;IAC5D,MAAM,EAAG,OAAO,CAAA;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,OAAO,EAAE,aAAa;cAKlB,KAAK,CACnB,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,WAAW,CAAC,EAAE,yBAAyB,EACvC,aAAa,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,WAAW,CAAC;IAIvB,IAAI,OAAO,IAAI,aAAa,CAE3B;CACF"}

package/dist/src/managers/tools/base.js

@@ -0,0 +1,17 @@
+import { StructuredTool } from '@langchain/core/tools';
+export class MCPServerTool extends StructuredTool {
+    name = 'mcp_server_tool';
+    description = 'Base tool for MCP server operations.';
+    schema;
+    _manager;
+    constructor(manager) {
+        super();
+        this._manager = manager;
+    }
+    async _call(_arg, _runManager, _parentConfig) {
+        throw new Error('Method not implemented.');
+    }
+    get manager() {
+        return this._manager;
+    }
+}

package/dist/src/managers/tools/connect_mcp_server.d.ts

@@ -0,0 +1,26 @@
+import type { ServerManager } from '../server_manager.js';
+import type { SchemaOutputT } from './base.js';
+import { z } from 'zod';
+import { MCPServerTool } from './base.js';
+declare const ConnectMCPServerSchema: z.ZodObject<{
+    serverName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    serverName: string;
+}, {
+    serverName: string;
+}>;
+export declare class ConnectMCPServerTool extends MCPServerTool<typeof ConnectMCPServerSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        serverName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        serverName: string;
+    }, {
+        serverName: string;
+    }>;
+    constructor(manager: ServerManager);
+    _call({ serverName }: SchemaOutputT<typeof ConnectMCPServerSchema>): Promise<string>;
+}
+export {};
+//# sourceMappingURL=connect_mcp_server.d.ts.map

package/dist/src/managers/tools/connect_mcp_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect_mcp_server.d.ts","sourceRoot":"","sources":["../../../../src/managers/tools/connect_mcp_server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,QAAA,MAAM,sBAAsB;;;;;;EAE1B,CAAA;AAEF,qBAAa,oBAAqB,SAAQ,aAAa,CAAC,OAAO,sBAAsB,CAAC;IAC3E,IAAI,SAA0B;IAC9B,WAAW,SAAiJ;IAC5J,MAAM;;;;;;OAAyB;gBAE5B,OAAO,EAAE,aAAa;IAI5B,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,aAAa,CAAC,OAAO,sBAAsB,CAAC;CAmCzE"}

package/dist/src/managers/tools/connect_mcp_server.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { logger } from '../../logging.js';
+import { MCPServerTool } from './base.js';
+const ConnectMCPServerSchema = z.object({
+    serverName: z.string().describe('The name of the MCP server.'),
+});
+export class ConnectMCPServerTool extends MCPServerTool {
+    name = 'connect_to_mcp_server';
+    description = 'Connect to a specific MCP (Model Context Protocol) server to use its tools. Use this tool to connect to a specific server and use its tools.';
+    schema = ConnectMCPServerSchema;
+    constructor(manager) {
+        super(manager);
+    }
+    async _call({ serverName }) {
+        const serverNames = this.manager.client.getServerNames();
+        if (!serverNames.includes(serverName)) {
+            const available = serverNames.length > 0 ? serverNames.join(', ') : 'none';
+            return `Server '${serverName}' not found. Available servers: ${available}`;
+        }
+        if (this.manager.activeServer === serverName) {
+            return `Already connected to MCP server '${serverName}'`;
+        }
+        try {
+            let session = this.manager.client.getSession(serverName);
+            logger.debug(`Using existing session for server '${serverName}'`);
+            if (!session) {
+                logger.debug(`Creating new session for server '${serverName}'`);
+                session = await this.manager.client.createSession(serverName);
+            }
+            this.manager.activeServer = serverName;
+            if (this.manager.serverTools[serverName]) {
+                const connector = session.connector;
+                const tools = await this.manager.adapter.createToolsFromConnectors([connector]);
+                this.manager.serverTools[serverName] = tools;
+                this.manager.initializedServers[serverName] = true;
+            }
+            const serverTools = this.manager.serverTools[serverName] || [];
+            const numTools = serverTools.length;
+            return `Connected to MCP server '${serverName}'. ${numTools} tools are now available.`;
+        }
+        catch (error) {
+            logger.error(`Error connecting to server '${serverName}': ${String(error)}`);
+            return `Failed to connect to server '${serverName}': ${String(error)}`;
+        }
+    }
+}

package/dist/src/managers/tools/index.d.ts

@@ -0,0 +1,5 @@
+export * from './acquire_active_mcp_server.js';
+export * from './connect_mcp_server.js';
+export * from './list_mcp_servers.js';
+export * from './release_mcp_server_connection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/managers/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/managers/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oCAAoC,CAAA"}

package/dist/src/managers/tools/index.js

@@ -0,0 +1,4 @@
+export * from './acquire_active_mcp_server.js';
+export * from './connect_mcp_server.js';
+export * from './list_mcp_servers.js';
+export * from './release_mcp_server_connection.js';

package/dist/src/managers/tools/list_mcp_servers.d.ts

@@ -0,0 +1,13 @@
+import type { ServerManager } from '../server_manager.js';
+import { z } from 'zod';
+import { MCPServerTool } from './base.js';
+declare const EnumerateServersSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare class ListMCPServersTool extends MCPServerTool<typeof EnumerateServersSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    constructor(manager: ServerManager);
+    _call(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=list_mcp_servers.d.ts.map

package/dist/src/managers/tools/list_mcp_servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_mcp_servers.d.ts","sourceRoot":"","sources":["../../../../src/managers/tools/list_mcp_servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,QAAA,MAAM,sBAAsB,gDAAe,CAAA;AAE3C,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,OAAO,sBAAsB,CAAC;IACzE,IAAI,SAAqB;IACzB,WAAW,SAAiN;IAC5N,MAAM,iDAAyB;gBAE5B,OAAO,EAAE,aAAa;IAI5B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAwB/B"}

package/dist/src/managers/tools/list_mcp_servers.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { logger } from '../../logging.js';
+import { MCPServerTool } from './base.js';
+const EnumerateServersSchema = z.object({});
+export class ListMCPServersTool extends MCPServerTool {
+    name = 'list_mcp_servers';
+    description = `Lists all available MCP (Model Context Protocol) servers that can be connected to, along with the tools available on each server. Use this tool to discover servers and see what functionalities they offer.`;
+    schema = EnumerateServersSchema;
+    constructor(manager) {
+        super(manager);
+    }
+    async _call() {
+        const serverNames = this.manager.client.getServerNames();
+        if (serverNames.length === 0) {
+            return `No MCP servers are currently defined.`;
+        }
+        const outputLines = ['Available MCP servers:'];
+        for (const serverName of serverNames) {
+            const isActiveServer = serverName === this.manager.activeServer;
+            const activeFlag = isActiveServer ? ' (ACTIVE)' : '';
+            outputLines.push(`- ${serverName}${activeFlag}`);
+            try {
+                const serverTools = this.manager.serverTools?.[serverName] ?? [];
+                const numberOfTools = Array.isArray(serverTools) ? serverTools.length : 0;
+                outputLines.push(`${numberOfTools} tools available for this server\n`);
+            }
+            catch (error) {
+                logger.error(`Unexpected error listing tools for server '${serverName}': ${String(error)}`);
+            }
+        }
+        return outputLines.join('\n');
+    }
+}

package/dist/src/managers/tools/release_mcp_server_connection.d.ts

@@ -0,0 +1,13 @@
+import type { ServerManager } from '../server_manager.js';
+import { z } from 'zod';
+import { MCPServerTool } from './base.js';
+declare const ReleaseConnectionSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare class ReleaseMCPServerConnectionTool extends MCPServerTool<typeof ReleaseConnectionSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    constructor(manager: ServerManager);
+    _call(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=release_mcp_server_connection.d.ts.map

package/dist/src/managers/tools/release_mcp_server_connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release_mcp_server_connection.d.ts","sourceRoot":"","sources":["../../../../src/managers/tools/release_mcp_server_connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,QAAA,MAAM,uBAAuB,gDAAe,CAAA;AAE5C,qBAAa,8BAA+B,SAAQ,aAAa,CAAC,OAAO,uBAAuB,CAAC;IACtF,IAAI,SAA+B;IACnC,WAAW,SAA6E;IACxF,MAAM,iDAA0B;gBAE7B,OAAO,EAAE,aAAa;IAI5B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAQ/B"}

package/dist/src/managers/tools/release_mcp_server_connection.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { MCPServerTool } from './base.js';
+const ReleaseConnectionSchema = z.object({});
+export class ReleaseMCPServerConnectionTool extends MCPServerTool {
+    name = 'disconnect_from_mcp_server';
+    description = 'Disconnect from the currently active MCP (Model Context Protocol) server';
+    schema = ReleaseConnectionSchema;
+    constructor(manager) {
+        super(manager);
+    }
+    async _call() {
+        if (!this.manager.activeServer) {
+            return `No MCP server is currently active, so there's nothing to disconnect from.`;
+        }
+        const serverName = this.manager.activeServer;
+        this.manager.activeServer = null;
+        return `Successfully disconnected from MCP server '${serverName}'.`;
+    }
+}

package/dist/src/session.d.ts

@@ -2,18 +2,10 @@ import type { BaseConnector } from './connectors/base.js';
 export declare class MCPSession {
     readonly connector: BaseConnector;
     private autoConnect;
-    private _sessionInfo;
-    private _tools;
     constructor(connector: BaseConnector, autoConnect?: boolean);
-    open(): Promise<this>;
-    close(): Promise<void>;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    initialize(): Promise<Record<string, any>>;
+    initialize(): Promise<void>;
     get isConnected(): boolean;
-    get sessionInfo(): Record<string, any> | null;
-    get tools(): Record<string, any>[];
-    discoverTools(): Promise<Record<string, any>[]>;
-    callTool(name: string, args: Record<string, any>): Promise<any>;
 }
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,qBAAa,UAAU;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,MAAM,CAA4B;gBAE9B,SAAS,EAAE,aAAa,EAAE,WAAW,UAAO;IAKlD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAUhD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAE5C;IAED,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAEjC;IAEK,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAK/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAOtE"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,qBAAa,UAAU;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,OAAO,CAAC,WAAW,CAAS;gBAEhB,SAAS,EAAE,aAAa,EAAE,WAAW,UAAO;IAKlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF"}

package/dist/src/session.js

@@ -1,20 +1,10 @@
-import { logger } from './logging.js';
 export class MCPSession {
     connector;
     autoConnect;
-    _sessionInfo = null;
-    _tools = [];
     constructor(connector, autoConnect = true) {
         this.connector = connector;
         this.autoConnect = autoConnect;
     }
-    async open() {
-        await this.connect();
-        return this;
-    }
-    async close() {
-        await this.disconnect();
-    }
     async connect() {
         await this.connector.connect();
     }
@@ -25,28 +15,9 @@ export class MCPSession {
         if (!this.isConnected && this.autoConnect) {
             await this.connect();
         }
-        this._sessionInfo = await this.connector.initialize() ?? {};
-        await this.discoverTools();
-        return this._sessionInfo;
+        await this.connector.initialize();
     }
     get isConnected() {
         return this.connector && this.connector.isClientConnected;
     }
-    get sessionInfo() {
-        return this._sessionInfo;
-    }
-    get tools() {
-        return this._tools;
-    }
-    async discoverTools() {
-        this._tools = this.connector.tools;
-        return this._tools;
-    }
-    async callTool(name, args) {
-        if (!this.isConnected && this.autoConnect) {
-            await this.connect();
-        }
-        logger.debug(`MCPSession calling tool '${name}'`);
-        return await this.connector.callTool(name, args);
-    }
 }

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "0.0.6",
+  "version": "0.0.8",
+  "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",
   "license": "MIT",
-  "homepage": "https://github.com/zandko/mcp-use#readme",
+  "homepage": "https://github.com/mcp-use/mcp-use-ts#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/zandko/mcp-use.git"
+    "url": "git+https://github.com/mcp-use/mcp-use-ts.git"
   },
   "bugs": {
-    "url": "https://github.com/zandko/mcp-use/issues"
+    "url": "https://github.com/mcp-use/mcp-use-ts/issues"
   },
   "keywords": [
     "MCP",
@@ -43,35 +44,49 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "fmt": "eslint --fix",
+    "release": "npm version patch --tag-version-prefix=v && git push --follow-tags",
+    "release:minor": "npm version minor --tag-version-prefix=v && git push --follow-tags",
+    "release:major": "npm version major --tag-version-prefix=v && git push --follow-tags",
+    "prepare": "husky"
+  },
   "dependencies": {
     "@dmitryrechkin/json-schema-to-zod": "^1.0.1",
-    "@langchain/community": "0.3.42",
-    "@langchain/core": "0.3.54",
-    "@modelcontextprotocol/sdk": "1.11.0",
+    "@langchain/community": "0.3.45",
+    "@langchain/core": "0.3.58",
+    "@modelcontextprotocol/sdk": "1.12.1",
     "eventsource": "^3.0.6",
-    "langchain": "^0.3.24",
+    "fastembed": "^1.14.4",
+    "langchain": "^0.3.27",
+    "lodash-es": "^4.17.21",
     "uuid": "^11.1.0",
     "winston": "^3.17.0",
     "ws": "^8.18.2",
-    "zod": "^3.24.4",
+    "zod": "^3.25.48",
     "zod-to-json-schema": "^3.24.5"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^4.13.0",
+    "@antfu/eslint-config": "^4.13.2",
+    "@types/lodash-es": "^4.17.12",
     "@types/ws": "^8.18.1",
-    "eslint": "^9.26.0",
+    "eslint": "^9.28.0",
     "eslint-plugin-format": "^1.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.2.11",
     "shx": "^0.4.0",
     "typescript": "^5.8.3"
   },
-  "scripts": {
-    "build": "rm -rf dist && tsc && shx chmod +x dist/*.js",
-    "watch": "tsc --watch",
-    "start": "node dist/index.js",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix",
-    "release": "npm version patch && git push --follow-tags",
-    "release:minor": "npm version minor && git push --follow-tags",
-    "release:major": "npm version major && git push --follow-tags"
+  "lint-staged": {
+    "*.{js,ts}": [
+      "eslint --fix",
+      "git add"
+    ]
   }
-}
+}

package/dist/src/agents/server_manager.d.ts

@@ -1,22 +0,0 @@
-import type { StructuredToolInterface } from '@langchain/core/tools';
-import type { LangChainAdapter } from '../adapters/langchain_adapter.js';
-import type { MCPClient } from '../client.js';
-export declare class ServerManager {
-    private readonly client;
-    private readonly adapter;
-    private activeServer;
-    private readonly initializedServers;
-    private readonly serverTools;
-    constructor(client: MCPClient, adapter: LangChainAdapter);
-    initialize(): Promise<void>;
-    getServerManagementTools(): Promise<StructuredToolInterface[]>;
-    listServers(): Promise<string>;
-    connectToServer(serverName: string): Promise<string>;
-    getActiveServer(): Promise<string>;
-    disconnectFromServer(): Promise<string>;
-    getActiveServerTools(): Promise<StructuredToolInterface[]>;
-    getAllTools(): Promise<StructuredToolInterface[]>;
-    private ensureSession;
-    private ensureToolsFetched;
-}
-//# sourceMappingURL=server_manager.d.ts.map

package/dist/src/agents/server_manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../../src/agents/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAc7C,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8B;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgD;gBAGzD,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB;IAGtC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,wBAAwB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAsC9D,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IA0B9B,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCpD,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAUvC,oBAAoB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAI1D,WAAW,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;YAIzC,aAAa;YAWb,kBAAkB;CAuBjC"}

package/dist/src/agents/server_manager.js

@@ -1,152 +0,0 @@
-import { DynamicStructuredTool } from '@langchain/core/tools';
-import { z } from 'zod';
-import { logger } from '../logging.js';
-const ServerActionInputSchema = z.object({
-    serverName: z.string().describe('The name of the MCP server'),
-});
-const DisconnectServerInputSchema = z.object({});
-const ListServersInputSchema = z.object({});
-const CurrentServerInputSchema = z.object({});
-export class ServerManager {
-    client;
-    adapter;
-    activeServer = null;
-    initializedServers = {};
-    serverTools = {};
-    constructor(client, adapter) {
-        this.client = client;
-        this.adapter = adapter;
-    }
-    async initialize() {
-        if (!this.client.getServerNames?.().length) {
-            logger.warning('No MCP servers defined in client configuration');
-        }
-    }
-    async getServerManagementTools() {
-        const listServersTool = new DynamicStructuredTool({
-            name: 'list_mcp_servers',
-            description: 'Lists all available MCP (Model Context Protocol) servers that can be connected to, along with the tools available on each server. Use this tool to discover servers and see what functionalities they offer.',
-            schema: ListServersInputSchema,
-            func: async () => this.listServers(),
-        });
-        const connectServerTool = new DynamicStructuredTool({
-            name: 'connect_to_mcp_server',
-            description: 'Connect to a specific MCP (Model Context Protocol) server to use its tools. Use this tool to connect to a specific server and use its tools.',
-            schema: ServerActionInputSchema,
-            func: async ({ serverName }) => this.connectToServer(serverName),
-        });
-        const getActiveServerTool = new DynamicStructuredTool({
-            name: 'get_active_mcp_server',
-            description: 'Get the currently active MCP (Model Context Protocol) server.',
-            schema: CurrentServerInputSchema,
-            func: async () => this.getActiveServer(),
-        });
-        const disconnectServerTool = new DynamicStructuredTool({
-            name: 'disconnect_from_mcp_server',
-            description: 'Disconnect from the currently active MCP (Model Context Protocol) server.',
-            schema: DisconnectServerInputSchema,
-            func: async () => this.disconnectFromServer(),
-        });
-        return [
-            listServersTool,
-            connectServerTool,
-            getActiveServerTool,
-            disconnectServerTool,
-        ];
-    }
-    async listServers() {
-        const servers = this.client.getServerNames?.() ?? [];
-        if (!servers.length)
-            return 'No MCP servers are currently defined.';
-        let out = 'Available MCP servers:\n';
-        for (const [idx, serverName] of servers.entries()) {
-            const active = serverName === this.activeServer ? ' (ACTIVE)' : '';
-            out += `${idx + 1}. ${serverName}${active}\n`;
-            try {
-                const tools = await this.ensureToolsFetched(serverName);
-                out += tools.length
-                    ? `   Tools: ${tools.map(t => t.name).join(', ')}\n`
-                    : '   Tools: (Could not retrieve or none available)\n';
-            }
-            catch (err) {
-                logger?.error?.(`Error listing tools for server '${serverName}':`, err);
-                out += '   Tools: (Error retrieving tools)\n';
-            }
-        }
-        return out;
-    }
-    async connectToServer(serverName) {
-        const servers = this.client.getServerNames() ?? [];
-        if (!servers.includes(serverName)) {
-            return `Server '${serverName}' not found. Available servers: ${servers.join(', ') || 'none'}`;
-        }
-        if (this.activeServer === serverName) {
-            return `Already connected to MCP server '${serverName}'`;
-        }
-        try {
-            const session = await this.ensureSession(serverName, /* create */ true);
-            this.activeServer = serverName;
-            // Ensure tools cached
-            await this.ensureToolsFetched(serverName, session?.connector);
-            const tools = this.serverTools[serverName] ?? [];
-            const toolDetails = tools
-                .map((t, i) => `${i + 1}. ${t.name}: ${t.description}`)
-                .join('\n');
-            return (`Connected to MCP server '${serverName}'. ${tools.length} tools are now available.${tools.length ? `\nAvailable tools for this server:\n${toolDetails}` : ''}`);
-        }
-        catch (err) {
-            logger.error(`Error connecting to server '${serverName}':`, err);
-            return `Failed to connect to server '${serverName}': ${String(err)}`;
-        }
-    }
-    async getActiveServer() {
-        return this.activeServer
-            ? `Currently active MCP server: ${this.activeServer}`
-            : 'No MCP server is currently active. Use connect_to_mcp_server to connect.';
-    }
-    async disconnectFromServer() {
-        if (!this.activeServer) {
-            return 'No MCP server is currently active, so there\'s nothing to disconnect from.';
-        }
-        const was = this.activeServer;
-        this.activeServer = null;
-        return `Successfully disconnected from MCP server '${was}'.`;
-    }
-    async getActiveServerTools() {
-        return this.activeServer ? this.serverTools[this.activeServer] ?? [] : [];
-    }
-    async getAllTools() {
-        return [...(await this.getServerManagementTools()), ...(await this.getActiveServerTools())];
-    }
-    async ensureSession(serverName, createIfMissing = false) {
-        try {
-            return this.client.getSession(serverName);
-        }
-        catch {
-            if (!createIfMissing)
-                return undefined;
-            return this.client.createSession ? await this.client.createSession(serverName) : undefined;
-        }
-    }
-    async ensureToolsFetched(serverName, connector) {
-        if (this.serverTools[serverName])
-            return this.serverTools[serverName];
-        const session = connector ? { connector } : await this.ensureSession(serverName, true);
-        if (!session) {
-            this.serverTools[serverName] = [];
-            return [];
-        }
-        try {
-            const tools = await this.adapter.createToolsFromConnectors([session.connector]);
-            this.serverTools[serverName] = tools;
-            this.initializedServers[serverName] = true;
-            logger.debug(`Fetched ${tools.length} tools for server '${serverName}'.`);
-            return tools;
-        }
-        catch (err) {
-            logger.warning(`Could not fetch tools for server '${serverName}':`, err);
-            this.serverTools[serverName] = [];
-            return [];
-        }
-    }
-}