@mastra/mcp 0.0.1-alpha.8 → 0.1.0-alpha.28

package/CHANGELOG.md

@@ -1,5 +1,164 @@
 # @mastra/mcp
 
+## 0.1.0-alpha.28
+
+### Minor Changes
+
+- 5916f9d: Update deps from fixed to ^
+
+### Patch Changes
+
+- Updated dependencies [6fa4bd2]
+- Updated dependencies [e2e76de]
+- Updated dependencies [7f24c29]
+- Updated dependencies [67637ba]
+- Updated dependencies [04f3171]
+  - @mastra/core@0.2.0-alpha.86
+
+## 0.0.1-alpha.27
+
+### Patch Changes
+
+- Updated dependencies [e9d1b47]
+  - @mastra/core@0.2.0-alpha.85
+
+## 0.0.1-alpha.26
+
+### Patch Changes
+
+- Updated dependencies [2f17a5f]
+- Updated dependencies [cb290ee]
+- Updated dependencies [b4d7416]
+- Updated dependencies [38b7f66]
+  - @mastra/core@0.2.0-alpha.84
+
+## 0.0.1-alpha.25
+
+### Patch Changes
+
+- 9625602: Use mastra core splitted bundles in other packages
+- Updated dependencies [30322ce]
+- Updated dependencies [78eec7c]
+- Updated dependencies [9625602]
+- Updated dependencies [8769a62]
+  - @mastra/core@0.2.0-alpha.83
+
+## 0.0.1-alpha.24
+
+### Patch Changes
+
+- Updated dependencies [73d112c]
+  - @mastra/core@0.1.27-alpha.82
+
+## 0.0.1-alpha.23
+
+### Patch Changes
+
+- Updated dependencies [9fb3039]
+  - @mastra/core@0.1.27-alpha.81
+
+## 0.0.1-alpha.22
+
+### Patch Changes
+
+- Updated dependencies [327ece7]
+  - @mastra/core@0.1.27-alpha.80
+
+## 0.0.1-alpha.21
+
+### Patch Changes
+
+- Updated dependencies [21fe536]
+  - @mastra/core@0.1.27-alpha.79
+
+## 0.0.1-alpha.20
+
+### Patch Changes
+
+- Updated dependencies [685108a]
+- Updated dependencies [685108a]
+  - @mastra/core@0.1.27-alpha.78
+
+## 0.0.1-alpha.19
+
+### Patch Changes
+
+- 8468b7f: @mastra/mcp tsup bundling
+- Updated dependencies [8105fae]
+  - @mastra/core@0.1.27-alpha.77
+
+## 0.0.1-alpha.18
+
+### Patch Changes
+
+- Updated dependencies [ae7bf94]
+- Updated dependencies [ae7bf94]
+  - @mastra/core@0.1.27-alpha.76
+
+## 0.0.1-alpha.17
+
+### Patch Changes
+
+- Updated dependencies [23dcb23]
+  - @mastra/core@0.1.27-alpha.75
+
+## 0.0.1-alpha.16
+
+### Patch Changes
+
+- Updated dependencies [7b87567]
+  - @mastra/core@0.1.27-alpha.74
+
+## 0.0.1-alpha.15
+
+### Patch Changes
+
+- Updated dependencies [3427b95]
+  - @mastra/core@0.1.27-alpha.73
+
+## 0.0.1-alpha.14
+
+### Patch Changes
+
+- Updated dependencies [e4d4ede]
+- Updated dependencies [06b2c0a]
+  - @mastra/core@0.1.27-alpha.72
+
+## 0.0.1-alpha.13
+
+### Patch Changes
+
+- Updated dependencies [d9c8dd0]
+  - @mastra/core@0.1.27-alpha.71
+
+## 0.0.1-alpha.12
+
+### Patch Changes
+
+- bdaf834: publish packages
+
+## 0.0.1-alpha.11
+
+### Patch Changes
+
+- Updated dependencies [dd6d87f]
+- Updated dependencies [04434b6]
+  - @mastra/core@0.1.27-alpha.70
+
+## 0.0.1-alpha.10
+
+### Patch Changes
+
+- 0d5a03d: Vector store modules
+
+## 0.0.1-alpha.9
+
+### Patch Changes
+
+- Updated dependencies [1944807]
+- Updated dependencies [9ade36e]
+  - @mastra/core@0.1.27-alpha.69
+
 ## 0.0.1-alpha.8
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,113 @@
+# @mastra/mcp
+
+Model Context Protocol (MCP) client implementation for Mastra, providing seamless integration with MCP-compatible AI models and tools.
+
+## Installation
+
+```bash
+npm install @mastra/mcp
+```
+
+## Overview
+
+The `@mastra/mcp` package provides a client implementation for the Model Context Protocol (MCP), enabling Mastra to communicate with MCP-compatible AI models and tools. It wraps the official `@modelcontextprotocol/sdk` and provides Mastra-specific functionality.
+
+## Usage
+
+```typescript
+import { MastraMCPClient } from '@mastra/mcp';
+
+// Create a client
+const client = new MastraMCPClient({
+  name: 'my-mcp-client',
+  version: '1.0.0', // optional
+  server: {
+    // StdioServerParameters
+    command: 'your-mcp-server-command',
+    args: ['--your', 'args'],
+  },
+  capabilities: {}, // optional ClientCapabilities
+});
+
+// Connect to the MCP server
+await client.connect();
+
+// List available resources
+const resources = await client.resources();
+
+// Get available tools
+const tools = await client.tools();
+
+// Disconnect when done
+await client.disconnect();
+```
+
+## Configuration
+
+### Required Parameters
+
+- `name`: Name of the MCP client instance
+- `server`: StdioServerParameters object containing:
+  - `command`: Command to start the MCP server
+  - `args`: Array of command arguments
+
+### Optional Parameters
+
+- `version`: Client version (default: '1.0.0')
+- `capabilities`: ClientCapabilities object for specifying supported features
+
+## Features
+
+- Standard MCP client implementation
+- Automatic tool conversion to Mastra format
+- Resource discovery and management
+- Stdio-based transport layer
+- Automatic error handling and logging
+- Tool execution with context
+
+## Methods
+
+### `connect()`
+
+Establishes connection with the MCP server.
+
+### `disconnect()`
+
+Closes the connection with the MCP server.
+
+### `resources()`
+
+Lists available resources from the MCP server.
+
+### `tools()`
+
+Retrieves and converts MCP tools to Mastra-compatible format.
+
+## Tool Conversion
+
+The package automatically converts MCP tools to Mastra's format:
+
+```typescript
+const tools = await client.tools();
+// Returns: { [toolName: string]: MastraTool }
+
+// Each tool includes:
+// - Converted JSON schema
+// - Mastra-compatible execution wrapper
+// - Error handling
+// - Automatic context passing
+```
+
+## Error Handling
+
+The client includes comprehensive error handling:
+
+- Connection errors
+- Tool execution errors
+- Resource listing errors
+- Schema conversion errors
+
+## Related Links
+
+- [Model Context Protocol Specification](https://github.com/modelcontextprotocol/spec)
+- [@modelcontextprotocol/sdk Documentation](https://github.com/modelcontextprotocol/sdk)

package/dist/index.d.ts

@@ -1,2 +1,42 @@
-export * from './client';
-//# sourceMappingURL=index.d.ts.map
+import * as zod from 'zod';
+import { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
+
+declare class MastraMCPClient {
+    name: string;
+    private transport;
+    private client;
+    constructor({ name, version, server, capabilities, }: {
+        name: string;
+        server: StdioServerParameters;
+        capabilities?: ClientCapabilities;
+        version?: string;
+    });
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    resources(): Promise<zod.objectOutputType<zod.objectUtil.extendShape<zod.objectUtil.extendShape<{
+        _meta: zod.ZodOptional<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
+    }, {
+        nextCursor: zod.ZodOptional<zod.ZodString>;
+    }>, {
+        resources: zod.ZodArray<zod.ZodObject<{
+            uri: zod.ZodString;
+            name: zod.ZodString;
+            description: zod.ZodOptional<zod.ZodString>;
+            mimeType: zod.ZodOptional<zod.ZodString>;
+        }, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{
+            uri: zod.ZodString;
+            name: zod.ZodString;
+            description: zod.ZodOptional<zod.ZodString>;
+            mimeType: zod.ZodOptional<zod.ZodString>;
+        }, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{
+            uri: zod.ZodString;
+            name: zod.ZodString;
+            description: zod.ZodOptional<zod.ZodString>;
+            mimeType: zod.ZodOptional<zod.ZodString>;
+        }, zod.ZodTypeAny, "passthrough">>, "many">;
+    }>, zod.ZodTypeAny, "passthrough">>;
+    tools(): Promise<Record<string, any>>;
+}
+
+export { MastraMCPClient };

package/dist/index.js

@@ -1,8 +1,70 @@
+import { createTool } from '@mastra/core/tools';
+import { jsonSchemaToModel } from '@mastra/core/utils';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { ListResourcesResultSchema } from '@modelcontextprotocol/sdk/types.js';
 
-'use strict'
+// src/client.ts
+var MastraMCPClient = class {
+  name;
+  transport;
+  client;
+  constructor({
+    name,
+    version = "1.0.0",
+    server,
+    capabilities = {}
+  }) {
+    this.name = name;
+    this.transport = new StdioClientTransport(server);
+    this.client = new Client(
+      {
+        name,
+        version
+      },
+      {
+        capabilities
+      }
+    );
+  }
+  async connect() {
+    return await this.client.connect(this.transport);
+  }
+  async disconnect() {
+    return await this.client.close();
+  }
+  async resources() {
+    return await this.client.request({ method: "resources/list" }, ListResourcesResultSchema);
+  }
+  async tools() {
+    const { tools } = await this.client.listTools();
+    const toolsRes = {};
+    tools.forEach((tool) => {
+      const s = jsonSchemaToModel(tool.inputSchema);
+      const mastraTool = createTool({
+        id: `${this.name}_${tool.name}`,
+        description: tool.description,
+        inputSchema: s,
+        execute: async ({ context }) => {
+          try {
+            const res = await this.client.callTool({
+              name: tool.name,
+              arguments: context
+            });
+            return res;
+          } catch (e) {
+            console.log("Error calling tool", tool.name);
+            console.error(e);
+            throw e;
+          }
+        }
+      });
+      if (tool.name) {
+        toolsRes[tool.name] = mastraTool;
+      }
+    });
+    return toolsRes;
+  }
+};
 
-if (process.env.NODE_ENV === 'production') {
-  module.exports = require('./mcp.cjs.production.min.js')
-} else {
-  module.exports = require('./mcp.cjs.development.js')
-}
+export { MastraMCPClient };

package/package.json

@@ -1,18 +1,13 @@
 {
   "name": "@mastra/mcp",
-  "version": "0.0.1-alpha.8",
+  "version": "0.1.0-alpha.28",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
-  "module": "dist/mcp.esm.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/mcp.esm.js"
-      },
-      "require": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
@@ -27,21 +22,19 @@
     "date-fns": "^4.1.0",
     "dotenv": "^16.3.1",
     "zod": "^3.24.1",
-    "@mastra/core": "0.1.27-alpha.68"
+    "@mastra/core": "^0.2.0-alpha.86"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.26.0",
     "@babel/preset-typescript": "^7.26.0",
     "@tsconfig/recommended": "^1.0.7",
-    "@types/jsdom": "^21.1.7",
     "@types/node": "^22.9.0",
-    "@types/pg": "^8.11.10",
-    "dts-cli": "^2.0.5",
-    "vitest": "^2.1.8"
+    "tsup": "^8.0.1",
+    "vitest": "^3.0.4"
   },
   "scripts": {
-    "build": "dts build",
-    "build:dev": "dts watch",
+    "build": "tsup src/index.ts --format esm --dts --clean --treeshake",
+    "dev": "tsup src/index.ts --format esm --dts --clean --treeshake --watch",
     "test": "vitest run"
   }
 }

package/src/client.test.ts

@@ -1,4 +1,5 @@
-import { Agent } from '@mastra/core';
+import { Agent } from '@mastra/core/agent';
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
 
 import { MastraMCPClient } from './client.js';
 

package/src/client.ts

@@ -1,7 +1,8 @@
-import { createTool, jsonSchemaToModel } from '@mastra/core';
+import { createTool } from '@mastra/core/tools';
+import { jsonSchemaToModel } from '@mastra/core/utils';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport, StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { ClientCapabilities, ListResourcesResultSchema } from '@modelcontextprotocol/sdk/types.js';
+import { StdioClientTransport, type StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { type ClientCapabilities, ListResourcesResultSchema } from '@modelcontextprotocol/sdk/types.js';
 
 export class MastraMCPClient {
   name: string;

package/tsconfig.json

@@ -1,10 +1,5 @@
 {
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "moduleResolution": "bundler",
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
+  "extends": "../../tsconfig.node.json",
   "include": ["src/**/*"],
   "exclude": ["node_modules", "**/*.test.ts"]
 }

package/dist/client.d.ts

@@ -1,39 +0,0 @@
-import { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
-export declare class MastraMCPClient {
-    name: string;
-    private transport;
-    private client;
-    constructor({ name, version, server, capabilities, }: {
-        name: string;
-        server: StdioServerParameters;
-        capabilities?: ClientCapabilities;
-        version?: string;
-    });
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    resources(): Promise<import("zod").objectOutputType<import("zod").objectUtil.extendShape<import("zod").objectUtil.extendShape<{
-        _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-    }, {
-        nextCursor: import("zod").ZodOptional<import("zod").ZodString>;
-    }>, {
-        resources: import("zod").ZodArray<import("zod").ZodObject<{
-            uri: import("zod").ZodString;
-            name: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
-        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
-            uri: import("zod").ZodString;
-            name: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
-        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
-            uri: import("zod").ZodString;
-            name: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
-        }, import("zod").ZodTypeAny, "passthrough">>, "many">;
-    }>, import("zod").ZodTypeAny, "passthrough">>;
-    tools(): Promise<Record<string, any>>;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAA6B,MAAM,oCAAoC,CAAC;AAEnG,qBAAa,eAAe;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAS;gBACX,EACV,IAAI,EACJ,OAAiB,EACjB,MAAM,EACN,YAAiB,GAClB,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,qBAAqB,CAAC;QAC9B,YAAY,CAAC,EAAE,kBAAkB,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAeK,OAAO;IAIP,UAAU;IAIV,SAAS;;;;;;;;;;;;;;;;;;;;;;IAIT,KAAK;CAgCZ"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}