@mastra/mcp 0.3.10-alpha.4 → 0.3.10-alpha.6

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/mcp@0.3.10-alpha.4 build /home/runner/work/mastra/mastra/packages/mcp
+> @mastra/mcp@0.3.10-alpha.6 build /home/runner/work/mastra/mastra/packages/mcp
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 TSC Build start
-TSC ⚡️ Build success in 14297ms
+TSC ⚡️ Build success in 14601ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.2
 Writing package typings: /home/runner/work/mastra/mastra/packages/mcp/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.2
 Writing package typings: /home/runner/work/mastra/mastra/packages/mcp/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 11360ms
+DTS ⚡️ Build success in 10596ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 7.48 KB
-CJS ⚡️ Build success in 610ms
-ESM dist/index.js 7.44 KB
-ESM ⚡️ Build success in 611ms
+ESM dist/index.js 128.98 KB
+ESM ⚡️ Build success in 2583ms
+CJS dist/index.cjs 129.02 KB
+CJS ⚡️ Build success in 2583ms

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp
 
+## 0.3.10-alpha.6
+
+### Patch Changes
+
+- Updated dependencies [d72318f]
+  - @mastra/core@0.8.3-alpha.5
+
+## 0.3.10-alpha.5
+
+### Patch Changes
+
+- Updated dependencies [7f1b291]
+  - @mastra/core@0.8.3-alpha.4
+
 ## 0.3.10-alpha.4
 
 ### Patch Changes

package/README.md

@@ -95,6 +95,97 @@ const tools = await mcp.getTools();
 const toolsets = await mcp.getToolsets();
 ```
 
+## Logging
+
+The MCP client provides per-server logging capabilities, allowing you to monitor interactions with each MCP server separately:
+
+```typescript
+import { MCPConfiguration, LogMessage, LoggingLevel } from '@mastra/mcp';
+
+// Define a custom log handler
+const weatherLogger = (logMessage: LogMessage) => {
+  console.log(`[${logMessage.level}] ${logMessage.serverName}: ${logMessage.message}`);
+
+  // Log data contains valuable information
+  console.log('Details:', logMessage.details);
+  console.log('Timestamp:', logMessage.timestamp);
+};
+
+// Initialize MCP configuration with server-specific loggers
+const mcp = new MCPConfiguration({
+  servers: {
+    weatherService: {
+      command: 'npx',
+      args: ['tsx', 'weather-mcp.ts'],
+      // Attach the logger to this specific server
+      log: weatherLogger,
+    },
+
+    stockPriceService: {
+      command: 'npx',
+      args: ['tsx', 'stock-mcp.ts'],
+      // Different logger for this service
+      log: logMessage => {
+        // Just log errors and critical events for this service
+        if (['error', 'critical', 'alert', 'emergency'].includes(logMessage.level)) {
+          console.error(`Stock service ${logMessage.level}: ${logMessage.message}`);
+        }
+      },
+    },
+  },
+});
+```
+
+### Log Message Structure
+
+Each log message contains the following information:
+
+```typescript
+interface LogMessage {
+  level: LoggingLevel; // MCP SDK standard log levels
+  message: string;
+  timestamp: Date;
+  serverName: string;
+  details?: Record<string, any>;
+}
+```
+
+The `LoggingLevel` type is directly imported from the MCP SDK, ensuring compatibility with all standard MCP log levels: `'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency'`.
+
+### Creating Reusable Loggers
+
+You can create reusable logger factories for common patterns:
+
+```typescript
+// File logger factory with color coded output for different severity levels
+const createFileLogger = filePath => {
+  return logMessage => {
+    // Format the message based on level
+    const prefix =
+      logMessage.level === 'emergency' ? '!!! EMERGENCY !!! ' : logMessage.level === 'alert' ? '! ALERT ! ' : '';
+
+    // Write to file with timestamp, level, etc.
+    fs.appendFileSync(
+      filePath,
+      `[${logMessage.timestamp.toISOString()}] [${logMessage.level.toUpperCase()}] ${prefix}${logMessage.message}\n`,
+    );
+  };
+};
+
+// Use the factory in configuration
+const mcp = new MCPConfiguration({
+  servers: {
+    weatherService: {
+      command: 'npx',
+      args: ['tsx', 'weather-mcp.ts'],
+      log: createFileLogger('./logs/weather.log'),
+    },
+  },
+});
+```
+
+See the `examples/server-logging.ts` file for comprehensive examples of various logging strategies.
+
 ### Tools vs Toolsets
 
 The MCPConfiguration class provides two ways to access MCP tools:
@@ -242,6 +333,7 @@ This configuration ensures that:
 
 - `version`: Client version (default: '1.0.0')
 - `capabilities`: ClientCapabilities object for specifying supported features
+- `log`: Function that receives and processes log messages
 
 ## Features
 
@@ -251,6 +343,7 @@ This configuration ensures that:
 - Multiple transport layers:
   - Stdio-based for local servers
   - SSE-based for remote servers
+- Per-server logging capability using all standard MCP log levels
 - Automatic error handling and logging
 - Tool execution with context
 

package/dist/_tsup-dts-rollup.d.cts

@@ -1,15 +1,35 @@
 import type { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
 import { MastraBase } from '@mastra/core/base';
 import type { Protocol } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import type { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
 import type { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
 
+export { LoggingLevel }
+export { LoggingLevel as LoggingLevel_alias_1 }
+
+declare type LogHandler = (logMessage: LogMessage) => void;
+export { LogHandler }
+export { LogHandler as LogHandler_alias_1 }
+
+declare interface LogMessage {
+    level: LoggingLevel;
+    message: string;
+    timestamp: Date;
+    serverName: string;
+    details?: Record<string, any>;
+}
+export { LogMessage }
+export { LogMessage as LogMessage_alias_1 }
+
 declare class MastraMCPClient extends MastraBase {
     name: string;
     private transport;
     private client;
     private readonly timeout;
+    private logHandler?;
+    private enableServerLogs?;
     constructor({ name, version, server, capabilities, timeout, }: {
         name: string;
         server: MastraMCPServerDefinition;
@@ -17,6 +37,14 @@ declare class MastraMCPClient extends MastraBase {
         version?: string;
         timeout?: number;
     });
+    /**
+     * Log a message at the specified level
+     * @param level Log level
+     * @param message Log message
+     * @param details Optional additional details
+     */
+    private log;
+    private setupLogging;
     private isConnected;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -26,7 +54,12 @@ declare class MastraMCPClient extends MastraBase {
 export { MastraMCPClient }
 export { MastraMCPClient as MastraMCPClient_alias_1 }
 
-declare type MastraMCPServerDefinition = StdioServerParametersWithTimeout | SSEClientParameters;
+declare type MastraMCPServerDefinition = (StdioServerParameters | SSEClientParameters) & {
+    logger?: LogHandler;
+    timeout?: number;
+    capabilities?: ClientCapabilities;
+    enableServerLogs?: boolean;
+};
 export { MastraMCPServerDefinition }
 export { MastraMCPServerDefinition as MastraMCPServerDefinition_alias_1 }
 
@@ -34,11 +67,7 @@ declare class MCPConfiguration extends MastraBase {
     private serverConfigs;
     private id;
     private defaultTimeout;
-    constructor(args: {
-        id?: string;
-        servers: Record<string, MastraMCPServerDefinition>;
-        timeout?: number;
-    });
+    constructor(args: MCPConfigurationOptions);
     private addToInstanceCache;
     private makeId;
     disconnect(): Promise<void>;
@@ -51,6 +80,14 @@ declare class MCPConfiguration extends MastraBase {
 export { MCPConfiguration }
 export { MCPConfiguration as MCPConfiguration_alias_1 }
 
+declare interface MCPConfigurationOptions {
+    id?: string;
+    servers: Record<string, MastraMCPServerDefinition>;
+    timeout?: number;
+}
+export { MCPConfigurationOptions }
+export { MCPConfigurationOptions as MCPConfigurationOptions_alias_1 }
+
 export declare const server: Server<{
     method: string;
     params?: {
@@ -101,11 +138,6 @@ export declare const server_alias_1: Server<{
 
 declare type SSEClientParameters = {
     url: URL;
-    timeout?: number;
 } & SSEClientTransportOptions;
 
-declare type StdioServerParametersWithTimeout = StdioServerParameters & {
-    timeout?: number;
-};
-
 export { }

package/dist/_tsup-dts-rollup.d.ts

@@ -1,15 +1,35 @@
 import type { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
 import { MastraBase } from '@mastra/core/base';
 import type { Protocol } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import type { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
 import type { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
 
+export { LoggingLevel }
+export { LoggingLevel as LoggingLevel_alias_1 }
+
+declare type LogHandler = (logMessage: LogMessage) => void;
+export { LogHandler }
+export { LogHandler as LogHandler_alias_1 }
+
+declare interface LogMessage {
+    level: LoggingLevel;
+    message: string;
+    timestamp: Date;
+    serverName: string;
+    details?: Record<string, any>;
+}
+export { LogMessage }
+export { LogMessage as LogMessage_alias_1 }
+
 declare class MastraMCPClient extends MastraBase {
     name: string;
     private transport;
     private client;
     private readonly timeout;
+    private logHandler?;
+    private enableServerLogs?;
     constructor({ name, version, server, capabilities, timeout, }: {
         name: string;
         server: MastraMCPServerDefinition;
@@ -17,6 +37,14 @@ declare class MastraMCPClient extends MastraBase {
         version?: string;
         timeout?: number;
     });
+    /**
+     * Log a message at the specified level
+     * @param level Log level
+     * @param message Log message
+     * @param details Optional additional details
+     */
+    private log;
+    private setupLogging;
     private isConnected;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -26,7 +54,12 @@ declare class MastraMCPClient extends MastraBase {
 export { MastraMCPClient }
 export { MastraMCPClient as MastraMCPClient_alias_1 }
 
-declare type MastraMCPServerDefinition = StdioServerParametersWithTimeout | SSEClientParameters;
+declare type MastraMCPServerDefinition = (StdioServerParameters | SSEClientParameters) & {
+    logger?: LogHandler;
+    timeout?: number;
+    capabilities?: ClientCapabilities;
+    enableServerLogs?: boolean;
+};
 export { MastraMCPServerDefinition }
 export { MastraMCPServerDefinition as MastraMCPServerDefinition_alias_1 }
 
@@ -34,11 +67,7 @@ declare class MCPConfiguration extends MastraBase {
     private serverConfigs;
     private id;
     private defaultTimeout;
-    constructor(args: {
-        id?: string;
-        servers: Record<string, MastraMCPServerDefinition>;
-        timeout?: number;
-    });
+    constructor(args: MCPConfigurationOptions);
     private addToInstanceCache;
     private makeId;
     disconnect(): Promise<void>;
@@ -51,6 +80,14 @@ declare class MCPConfiguration extends MastraBase {
 export { MCPConfiguration }
 export { MCPConfiguration as MCPConfiguration_alias_1 }
 
+declare interface MCPConfigurationOptions {
+    id?: string;
+    servers: Record<string, MastraMCPServerDefinition>;
+    timeout?: number;
+}
+export { MCPConfigurationOptions }
+export { MCPConfigurationOptions as MCPConfigurationOptions_alias_1 }
+
 export declare const server: Server<{
     method: string;
     params?: {
@@ -101,11 +138,6 @@ export declare const server_alias_1: Server<{
 
 declare type SSEClientParameters = {
     url: URL;
-    timeout?: number;
 } & SSEClientTransportOptions;
 
-declare type StdioServerParametersWithTimeout = StdioServerParameters & {
-    timeout?: number;
-};
-
 export { }