@mastra/mcp 0.1.1 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,18 +1,19 @@
-
-> @mastra/mcp@0.1.1-alpha.0 build C:\Users\Ward\projects\mastra\mastra\packages\mcp
-> tsup src/index.ts --format esm --experimental-dts --clean --treeshake
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.3.6
-TSC Build start
-TSC ⚡️ Build success in 4014ms
-DTS Build start
-CLI Target: es2022
-Analysis will use the bundled TypeScript version 5.7.3
-Writing package typings: C:\Users\Ward\projects\mastra\mastra\packages\mcp\dist\_tsup-dts-rollup.d.ts
-DTS ⚡️ Build success in 3403ms
-CLI Cleaning output folder
-ESM Build start
-ESM dist\index.js 1.77 KB
-ESM ⚡️ Build success in 154ms
+
+
+> @mastra/mcp@0.2.0 build /Users/ward/projects/mastra/mastra/packages/mcp
+> tsup src/index.ts --format esm --experimental-dts --clean --treeshake
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.3.6
+TSC Build start
+TSC ⚡️ Build success in 2103ms
+DTS Build start
+CLI Target: es2022
+Analysis will use the bundled TypeScript version 5.7.3
+Writing package typings: /Users/ward/projects/mastra/mastra/packages/mcp/dist/_tsup-dts-rollup.d.ts
+DTS ⚡️ Build success in 1310ms
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.js 2.19 KB
+ESM ⚡️ Build success in 120ms

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @mastra/mcp
 
+## 0.2.0
+
+### Minor Changes
+
+- 5b7d6fa: Added support for SSE MCP servers in the Mastra MCP client
+
+## 0.2.0-alpha.0
+
+### Minor Changes
+
+- 5b7d6fa: Added support for SSE MCP servers in the Mastra MCP client
+
 ## 0.1.1
 
 ### Patch Changes

package/README.md

@@ -17,18 +17,29 @@ The `@mastra/mcp` package provides a client implementation for the Model Context
 ```typescript
 import { MastraMCPClient } from '@mastra/mcp';
 
-// Create a client
-const client = new MastraMCPClient({
-  name: 'my-mcp-client',
+// Create a client with stdio server
+const stdioClient = new MastraMCPClient({
+  name: 'my-stdio-client',
   version: '1.0.0', // optional
   server: {
-    // StdioServerParameters
     command: 'your-mcp-server-command',
     args: ['--your', 'args'],
   },
   capabilities: {}, // optional ClientCapabilities
 });
 
+// Or create a client with SSE server
+const sseClient = new MastraMCPClient({
+  name: 'my-sse-client',
+  version: '1.0.0',
+  server: {
+    url: new URL('https://your-mcp-server.com/sse'),
+    requestInit: {
+      headers: { 'Authorization': 'Bearer your-token' }
+    }
+  }
+});
+
 // Connect to the MCP server
 await client.connect();
 
@@ -47,9 +58,16 @@ await client.disconnect();
 ### Required Parameters
 
 - `name`: Name of the MCP client instance
-- `server`: StdioServerParameters object containing:
+- `server`: Either a StdioServerParameters or SSEClientParameters object:
+  
+  #### StdioServerParameters
   - `command`: Command to start the MCP server
   - `args`: Array of command arguments
+  
+  #### SSEClientParameters
+  - `url`: URL instance pointing to the SSE server
+  - `requestInit`: Optional fetch request configuration
+  - `eventSourceInit`: Optional EventSource configuration
 
 ### Optional Parameters
 
@@ -61,7 +79,9 @@ await client.disconnect();
 - Standard MCP client implementation
 - Automatic tool conversion to Mastra format
 - Resource discovery and management
-- Stdio-based transport layer
+- Multiple transport layers:
+  - Stdio-based for local servers
+  - SSE-based for remote servers
 - Automatic error handling and logging
 - Tool execution with context
 

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

@@ -1,13 +1,7 @@
 import type { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
-import { objectInputType } from 'zod';
-import { objectOutputType } from 'zod';
-import { objectUtil } from 'zod';
+import type { Protocol } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import type { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { ZodArray } from 'zod';
-import { ZodObject } from 'zod';
-import { ZodOptional } from 'zod';
-import { ZodString } from 'zod';
-import { ZodTypeAny } from 'zod';
 
 declare class MastraMCPClient {
     name: string;
@@ -15,37 +9,20 @@ declare class MastraMCPClient {
     private client;
     constructor({ name, version, server, capabilities, }: {
         name: string;
-        server: StdioServerParameters;
+        server: StdioServerParameters | SSEClientParameters;
         capabilities?: ClientCapabilities;
         version?: string;
     });
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    resources(): Promise<objectOutputType<objectUtil.extendShape<objectUtil.extendShape<    {
-    _meta: ZodOptional<ZodObject<    {}, "passthrough", ZodTypeAny, objectOutputType<    {}, ZodTypeAny, "passthrough">, objectInputType<    {}, ZodTypeAny, "passthrough">>>;
-    }, {
-    nextCursor: ZodOptional<ZodString>;
-    }>, {
-    resources: ZodArray<ZodObject<    {
-    uri: ZodString;
-    name: ZodString;
-    description: ZodOptional<ZodString>;
-    mimeType: ZodOptional<ZodString>;
-    }, "passthrough", ZodTypeAny, objectOutputType<    {
-    uri: ZodString;
-    name: ZodString;
-    description: ZodOptional<ZodString>;
-    mimeType: ZodOptional<ZodString>;
-    }, ZodTypeAny, "passthrough">, objectInputType<    {
-    uri: ZodString;
-    name: ZodString;
-    description: ZodOptional<ZodString>;
-    mimeType: ZodOptional<ZodString>;
-    }, ZodTypeAny, "passthrough">>, "many">;
-    }>, ZodTypeAny, "passthrough">>;
+    resources(): Promise<ReturnType<Protocol<any, any, any>['request']>>;
     tools(): Promise<Record<string, any>>;
 }
 export { MastraMCPClient }
 export { MastraMCPClient as MastraMCPClient_alias_1 }
 
+declare type SSEClientParameters = {
+    url: URL;
+} & ConstructorParameters<typeof SSEClientTransport>[1];
+
 export { }

package/dist/index.js

@@ -1,6 +1,7 @@
 import { createTool } from '@mastra/core/tools';
 import { jsonSchemaToModel } from '@mastra/core/utils';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { ListResourcesResultSchema } from '@modelcontextprotocol/sdk/types.js';
 
@@ -16,7 +17,14 @@ var MastraMCPClient = class {
     capabilities = {}
   }) {
     this.name = name;
-    this.transport = new StdioClientTransport(server);
+    if (`url` in server) {
+      this.transport = new SSEClientTransport(server.url, {
+        requestInit: server.requestInit,
+        eventSourceInit: server.eventSourceInit
+      });
+    } else {
+      this.transport = new StdioClientTransport(server);
+    }
     this.client = new Client(
       {
         name,
@@ -33,6 +41,7 @@ var MastraMCPClient = class {
   async disconnect() {
     return await this.client.close();
   }
+  // TODO: do the type magic to return the right method type. Right now we get infinitely deep infered type errors from Zod without using "any"
   async resources() {
     return await this.client.request({ method: "resources/list" }, ListResourcesResultSchema);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "",
   "type": "module",
   "main": "dist/index.js",

package/src/client.ts

@@ -1,14 +1,21 @@
 import { createTool } from '@mastra/core/tools';
 import { jsonSchemaToModel } from '@mastra/core/utils';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 import type { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { ListResourcesResultSchema } from '@modelcontextprotocol/sdk/types.js';
+import type { Protocol } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import type { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import { ListResourcesResultSchema } from '@modelcontextprotocol/sdk/types.js';
+
+type SSEClientParameters = {
+  url: URL;
+} & ConstructorParameters<typeof SSEClientTransport>[1];
 
 export class MastraMCPClient {
   name: string;
-  private transport: StdioClientTransport;
+  private transport: Transport;
   private client: Client;
   constructor({
     name,
@@ -17,12 +24,20 @@ export class MastraMCPClient {
     capabilities = {},
   }: {
     name: string;
-    server: StdioServerParameters;
+    server: StdioServerParameters | SSEClientParameters;
     capabilities?: ClientCapabilities;
     version?: string;
   }) {
     this.name = name;
-    this.transport = new StdioClientTransport(server);
+
+    if (`url` in server) {
+      this.transport = new SSEClientTransport(server.url, {
+        requestInit: server.requestInit,
+        eventSourceInit: server.eventSourceInit,
+      });
+    } else {
+      this.transport = new StdioClientTransport(server);
+    }
 
     this.client = new Client(
       {
@@ -43,7 +58,9 @@ export class MastraMCPClient {
     return await this.client.close();
   }
 
-  async resources() {
+  // TODO: do the type magic to return the right method type. Right now we get infinitely deep infered type errors from Zod without using "any"
+
+  async resources(): Promise<ReturnType<Protocol<any, any, any>['request']>> {
     return await this.client.request({ method: 'resources/list' }, ListResourcesResultSchema);
   }
 

package/.turbo/turbo-lint.log

@@ -1,4 +0,0 @@
-
-> @mastra/mcp@0.1.0 lint C:\Users\Ward\projects\mastra\mastra\packages\mcp
-> eslint .
-