@mastra/mcp 1.2.2-alpha.0 → 1.3.0-alpha.1

package/dist/index.js

@@ -685,6 +685,19 @@ var InternalMastraMCPClient = class extends MastraBase {
     }
     return void 0;
   }
+  /**
+   * Gets the stderr stream of the child process, if using stdio transport with `stderr: 'pipe'`.
+   *
+   * Returns null if not connected, not using stdio transport, or stderr is not piped.
+   *
+   * @internal
+   */
+  get stderr() {
+    if (this.transport instanceof StdioClientTransport) {
+      return this.transport.stderr;
+    }
+    return null;
+  }
   async disconnect() {
     if (!this.transport) {
       this.log("debug", "Disconnect called but no transport was connected.");
@@ -1617,6 +1630,29 @@ To fix this you have three different options:
     })();
     return this.disconnectPromise;
   }
+  /**
+   * Reconnects a single MCP server by name.
+   *
+   * If the server is already connected, it will be forcefully disconnected and reconnected.
+   * If the server has never been connected, a new connection will be established.
+   *
+   * @param serverName - The name of the server to reconnect (must match a key in `servers`)
+   * @throws {Error} If the server name is not found in the configuration
+   *
+   * @example
+   * ```typescript
+   * // Reconnect a specific server after it fails
+   * await mcp.reconnectServer('weatherServer');
+   * ```
+   */
+  async reconnectServer(serverName) {
+    const existingClient = this.mcpClientsById.get(serverName);
+    if (existingClient) {
+      await existingClient.forceReconnect();
+    } else {
+      await this.getConnectedClientForServer(serverName);
+    }
+  }
   /**
    * Retrieves all tools from all configured servers with namespaced names.
    *
@@ -1689,8 +1725,29 @@ To fix this you have three different options:
    * ```
    */
   async listToolsets() {
+    const result = await this.listToolsetsWithErrors();
+    return result.toolsets;
+  }
+  /**
+   * Returns toolsets organized by server name, along with any per-server errors.
+   *
+   * Like listToolsets(), but also returns errors for servers that failed to connect
+   * or list tools. This allows callers to report specific failure reasons per server.
+   *
+   * @returns Object with `toolsets` (successful servers) and `errors` (failed servers with error messages).
+   *
+   * @example
+   * ```typescript
+   * const { toolsets, errors } = await mcp.listToolsetsWithErrors();
+   * for (const [name, err] of Object.entries(errors)) {
+   *   console.error(`Server ${name} failed: ${err}`);
+   * }
+   * ```
+   */
+  async listToolsetsWithErrors() {
     this.addToInstanceCache();
     const connectedToolsets = {};
+    const errors = {};
     for (const serverName of Object.keys(this.serverConfigs)) {
       try {
         const client = await this.getConnectedClientForServer(serverName);
@@ -1712,9 +1769,10 @@ To fix this you have three different options:
         );
         this.logger.trackException(mastraError);
         this.logger.error("Failed to list toolsets from server:", { error: mastraError.toString() });
+        errors[serverName] = error instanceof Error ? error.message : String(error);
       }
     }
-    return connectedToolsets;
+    return { toolsets: connectedToolsets, errors };
   }
   /**
    * Gets current session IDs for all connected MCP clients using Streamable HTTP transport.
@@ -1740,6 +1798,20 @@ To fix this you have three different options:
     }
     return sessionIds;
   }
+  /**
+   * Gets the stderr stream of a connected stdio server.
+   *
+   * Only available for servers using stdio transport with `stderr: 'pipe'`.
+   * Returns null if the server is not connected, not using stdio, or stderr is not piped.
+   *
+   * @param serverName - The name of the server
+   * @returns The stderr stream, or null
+   */
+  getServerStderr(serverName) {
+    const client = this.mcpClientsById.get(serverName);
+    if (!client) return null;
+    return client.stderr;
+  }
   async getConnectedClient(name, config) {
     if (this.disconnectPromise) {
       await this.disconnectPromise;