@mastra/mcp 0.11.3-alpha.1 → 0.11.3-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @mastra/mcp
 
+## 0.11.3-alpha.2
+
+### Patch Changes
+
+- [#7343](https://github.com/mastra-ai/mastra/pull/7343) [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e) Thanks [@LekoArts](https://github.com/LekoArts)! - Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
+
+- Updated dependencies [[`85ef90b`](https://github.com/mastra-ai/mastra/commit/85ef90bb2cd4ae4df855c7ac175f7d392c55c1bf), [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e)]:
+  - @mastra/core@0.15.3-alpha.5
+
 ## 0.11.3-alpha.1
 
 ### Patch Changes

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@mastra/mcp",
-  "version": "0.11.3-alpha.1",
+  "version": "0.11.3-alpha.2",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
   "exports": {
     ".": {
       "import": {
@@ -53,8 +57,17 @@
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
     "@internal/lint": "0.0.34",
-    "@internal/types-builder": "0.0.9",
-    "@mastra/core": "0.15.3-alpha.4"
+    "@mastra/core": "0.15.3-alpha.5",
+    "@internal/types-builder": "0.0.9"
+  },
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
   },
   "scripts": {
     "build": "tsup --silent --config tsup.config.ts",

package/.turbo/turbo-build.log

@@ -1,4 +0,0 @@
-
-> @mastra/mcp@0.11.3-alpha.1 build /home/runner/work/mastra/mastra/packages/mcp
-> tsup --silent --config tsup.config.ts
-

package/eslint.config.js

@@ -1,11 +0,0 @@
-import { createConfig } from '@internal/lint/eslint';
-
-const config = await createConfig();
-
-/** @type {import("eslint").Linter.Config[]} */
-export default [
-  ...config,
-  {
-    ignores: ['**/integration-tests/**'],
-  },
-];

package/integration-tests/node_modules/.bin/tsc

@@ -1,21 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/node_modules"
-else
-  export NODE_PATH="/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/node_modules:$NODE_PATH"
-fi
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
-else
-  exec node  "$basedir/../typescript/bin/tsc" "$@"
-fi

package/integration-tests/node_modules/.bin/tsserver

@@ -1,21 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/node_modules"
-else
-  export NODE_PATH="/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/node_modules:$NODE_PATH"
-fi
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
-else
-  exec node  "$basedir/../typescript/bin/tsserver" "$@"
-fi

package/integration-tests/node_modules/.bin/vitest

@@ -1,21 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/mastra/mastra/node_modules/.pnpm/vitest@3.2.4_@types+debug@4.1.12_@types+node@20.19.11_@vitest+ui@3.2.3_jiti@2.4.2_jsdom_70e728ef477f1e37b982af437efd45b2/node_modules/vitest/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/vitest@3.2.4_@types+debug@4.1.12_@types+node@20.19.11_@vitest+ui@3.2.3_jiti@2.4.2_jsdom_70e728ef477f1e37b982af437efd45b2/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/node_modules"
-else
-  export NODE_PATH="/home/runner/work/mastra/mastra/node_modules/.pnpm/vitest@3.2.4_@types+debug@4.1.12_@types+node@20.19.11_@vitest+ui@3.2.3_jiti@2.4.2_jsdom_70e728ef477f1e37b982af437efd45b2/node_modules/vitest/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/vitest@3.2.4_@types+debug@4.1.12_@types+node@20.19.11_@vitest+ui@3.2.3_jiti@2.4.2_jsdom_70e728ef477f1e37b982af437efd45b2/node_modules:/home/runner/work/mastra/mastra/node_modules/.pnpm/node_modules:$NODE_PATH"
-fi
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
-else
-  exec node  "$basedir/../vitest/vitest.mjs" "$@"
-fi

package/integration-tests/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "mcp-server-integration-tests",
-  "private": true,
-  "version": "0.1.0",
-  "scripts": {
-    "test:mcp": "vitest run ./src/server.test.ts",
-    "dev": "mastra dev"
-  },
-  "dependencies": {
-    "@ai-sdk/openai": "^1.3.24",
-    "@ai-sdk/react": "^1.2.12",
-    "@mastra/client-js": "workspace:*",
-    "@mastra/mcp": "workspace:*",
-    "dotenv": "^16.6.1",
-    "zod": "^3.25.76"
-  },
-  "devDependencies": {
-    "@mastra/core": "workspace:*",
-    "@testing-library/react": "^16.3.0",
-    "@types/node": "^20.17.57",
-    "get-port": "^7.1.0",
-    "mastra": "workspace:*",
-    "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
-  },
-  "peerDependencies": {
-    "@mastra/core": ">=0.10.7-0 <0.16.0-0"
-  }
-}

package/integration-tests/src/mastra/agents/weather.ts

@@ -1,34 +0,0 @@
-import { openai } from '@ai-sdk/openai';
-import { createTool } from '@mastra/core/tools';
-import { Agent } from '@mastra/core/agent';
-import { z } from 'zod';
-import { weatherTool } from '../tools/weather';
-import { MCPClient } from '@mastra/mcp';
-
-const client = new MCPClient({
-  id: 'weather-server',
-  servers: {
-    weather: {
-      url: new URL(`http://localhost:4114/api/mcp/myMcpServer/mcp`),
-    },
-  },
-});
-
-export const weatherAgent = new Agent({
-  name: 'test',
-  instructions:
-    'You are a weather agent. When asked about weather in any city, use the get_weather tool with the city name as the postal code. When asked for clipboard contents you also get that.',
-  model: openai('gpt-4o'),
-  tools: async () => {
-    const tools = await client.getTools();
-    return {
-      get_weather: weatherTool,
-      clipboard: createTool({
-        id: 'clipboard',
-        description: 'Returns the contents of the users clipboard',
-        inputSchema: z.object({}),
-      }),
-      ...tools,
-    };
-  },
-});

package/integration-tests/src/mastra/index.ts

@@ -1,15 +0,0 @@
-import { Mastra } from '@mastra/core';
-import { weatherAgent } from './agents/weather';
-import { myMcpServer } from './mcp';
-
-export const mastra = new Mastra({
-  agents: {
-    test: weatherAgent,
-  },
-  mcpServers: {
-    myMcpServer,
-  },
-  server: {
-    port: 4114,
-  },
-});

package/integration-tests/src/mastra/mcp/index.ts

@@ -1,46 +0,0 @@
-import { createTool } from '@mastra/core/tools';
-import { MCPServer } from '@mastra/mcp';
-import { z } from 'zod';
-
-export const myMcpServer = new MCPServer({
-  name: 'My Calculation & Data MCP Server',
-  version: '1.0.0',
-  tools: {
-    calculator: createTool({
-      id: 'calculator',
-      description: 'Performs basic arithmetic operations (add, subtract).',
-      inputSchema: z.object({
-        num1: z.number().describe('The first number.'),
-        num2: z.number().describe('The second number.'),
-        operation: z.enum(['add', 'subtract']).describe('The operation to perform.'),
-      }),
-      execute: async ({ context }) => {
-        const { num1, num2, operation } = context;
-        if (operation === 'add') {
-          return num1 + num2;
-        }
-        if (operation === 'subtract') {
-          return num1 - num2;
-        }
-        throw new Error('Invalid operation');
-      },
-    }),
-    fetchWeather: createTool({
-      id: 'fetchWeather',
-      description: 'Fetches a (simulated) weather forecast for a given city.',
-      inputSchema: z.object({
-        city: z.string().describe('The city to get weather for, e.g., London, Paris.'),
-      }),
-      execute: async ({ context }) => {
-        const { city } = context;
-        const temperatures = {
-          london: '15°C',
-          paris: '18°C',
-          tokyo: '22°C',
-        };
-        const temp = temperatures[city.toLowerCase() as keyof typeof temperatures] || '20°C';
-        return `The weather in ${city} is ${temp} and sunny.`;
-      },
-    }),
-  },
-});

package/integration-tests/src/mastra/tools/weather.ts

@@ -1,13 +0,0 @@
-import { createTool } from '@mastra/core/tools';
-import { z } from 'zod';
-
-export const weatherTool = createTool({
-  id: 'get_weather',
-  description: 'Get the weather for a given location',
-  inputSchema: z.object({
-    postalCode: z.string().describe('The location to get the weather for'),
-  }),
-  execute: async ({ context: { postalCode } }) => {
-    return `The weather in ${postalCode} is sunny. It is currently 70 degrees and feels like 65 degrees.`;
-  },
-});

package/integration-tests/src/server.test.ts

@@ -1,238 +0,0 @@
-import { spawn } from 'node:child_process';
-import { MCPClient } from '@mastra/mcp';
-import { describe, it, expect, beforeAll, afterAll, vi } from 'vitest';
-import { ServerInfo } from '@mastra/core/mcp';
-import path from 'node:path';
-
-vi.setConfig({ testTimeout: 20000, hookTimeout: 20000 });
-
-describe('MCPServer through Mastra HTTP Integration (Subprocess)', () => {
-  let mastraServer: ReturnType<typeof spawn>;
-  const port: number = 4114;
-  const mcpServerId = 'myMcpServer';
-  const testToolId = 'calculator';
-  let client: MCPClient;
-
-  beforeAll(async () => {
-    mastraServer = spawn(
-      'pnpm',
-      [
-        path.resolve(import.meta.dirname, `..`, `..`, `..`, `cli`, `dist`, `index.js`),
-        'dev',
-        '--port',
-        port.toString(),
-      ],
-      {
-        stdio: 'pipe',
-        detached: true, // Run in a new process group so we can kill it and children
-      },
-    );
-
-    // Wait for server to be ready
-    await new Promise<void>((resolve, reject) => {
-      let output = '';
-      mastraServer.stdout?.on('data', data => {
-        output += data.toString();
-        console.log(output);
-        if (output.includes('http://localhost:')) {
-          resolve();
-        }
-      });
-      mastraServer.stderr?.on('data', data => {
-        console.error('Mastra server error:', data.toString());
-      });
-
-      setTimeout(() => reject(new Error('Mastra server failed to start')), 100000);
-    });
-
-    client = new MCPClient({
-      servers: {
-        [mcpServerId]: {
-          url: new URL(`http://localhost:${port}/api/mcp/${mcpServerId}/mcp`),
-        },
-      },
-    });
-  });
-
-  afterAll(() => {
-    // Kill the server and its process group
-    if (mastraServer?.pid) {
-      try {
-        process.kill(-mastraServer.pid, 'SIGTERM');
-      } catch (e) {
-        console.error('Failed to kill Mastra server:', e);
-      }
-    }
-  });
-
-  it('should allow an HTTP client to call a tool via Mastra MCP endpoint (Subprocess)', async () => {
-    const toolCallPayload = {
-      jsonrpc: '2.0',
-      id: `test-${Date.now()}`,
-      method: 'CallTool',
-      params: {
-        name: testToolId,
-        args: { num1: 10, num2: 5, operation: 'add' },
-      },
-    };
-
-    const tools = await client.getTools();
-    console.log('Tools:', tools);
-
-    const tool = tools['myMcpServer_calculator'];
-    console.log('Tool:', tool);
-
-    const result = await tool.execute({ context: toolCallPayload.params.args });
-    console.log('Result:', result);
-
-    expect(result).toBeDefined();
-    expect(result.isError).toBe(false);
-    expect(result.content).toBeInstanceOf(Array);
-    expect(result.content.length).toBeGreaterThan(0);
-
-    const toolOutput = result.content[0];
-    expect(toolOutput.type).toBe('text');
-
-    const expectedToolResult = 15;
-    expect(JSON.parse(toolOutput.text)).toEqual(expectedToolResult);
-  }, 25000);
-
-  it('should allow a client to call a tool via Mastra MCP SSE endpoints (Subprocess)', async () => {
-    const sseUrl = new URL(`http://localhost:${port}/api/mcp/${mcpServerId}/sse`);
-
-    // Configure MCPClient for SSE transport
-    const sseClient = new MCPClient({
-      servers: {
-        [mcpServerId]: {
-          url: sseUrl, // URL for establishing SSE connection
-        },
-      },
-    });
-
-    const toolCallPayloadParams = { num1: 10, num2: 5, operation: 'add' };
-
-    // Get tools (this will connect the client internally if not already connected)
-    const tools = await sseClient.getTools();
-
-    const toolName = `${mcpServerId}_${testToolId}`;
-    const tool = tools[toolName];
-    expect(tool, `Tool '${toolName}' should be available via SSE client`).toBeDefined();
-
-    // Execute the tool
-    const result = await tool.execute({ context: toolCallPayloadParams });
-
-    expect(result).toBeDefined();
-    expect(result.isError).toBe(false);
-    expect(result.content).toBeInstanceOf(Array);
-    expect(result.content.length).toBeGreaterThan(0);
-
-    const toolOutput = result.content[0];
-    expect(toolOutput.type).toBe('text');
-
-    const expectedToolResult = 15; // 10 + 5
-    expect(JSON.parse(toolOutput.text)).toEqual(expectedToolResult);
-  }, 25000);
-
-  // --- New tests for MCP Registry API Style Routes ---
-  describe('MCP Registry API Style Endpoints', () => {
-    const defaultMcpServerLogicalId = 'myMcpServer'; // Assuming this is the ID of the default server
-
-    it('GET /api/mcp/v0/servers - should list available MCP servers', async () => {
-      const response = await fetch(`http://localhost:${port}/api/mcp/v0/servers`);
-      expect(response.status).toBe(200);
-      expect(response.headers.get('content-type')).toContain('application/json');
-      const body = await response.json();
-
-      expect(body).toHaveProperty('servers');
-      expect(body).toHaveProperty('total_count');
-      expect(Array.isArray(body.servers)).toBe(true);
-      expect(body.total_count).toBeGreaterThanOrEqual(1); // Expect at least the default server
-
-      const defaultServerInfo: ServerInfo = body.servers.find((s: ServerInfo) => s.id === defaultMcpServerLogicalId);
-      expect(defaultServerInfo).toBeDefined();
-      expect(defaultServerInfo).toHaveProperty('name');
-      expect(defaultServerInfo).toHaveProperty('version_detail');
-      // Based on default mastra dev setup, if myMcpServer is the key, its id becomes 'myMcpServer'
-      // And its name might be something like 'my-mcp-server' if not explicitly set in MCPServerConfig for it.
-      // For this test, we assume the `id` is the key used in Mastra config.
-      expect(defaultServerInfo.id).toBe(defaultMcpServerLogicalId);
-    });
-
-    it('GET /api/mcp/v0/servers/:id - should get specific server details', async () => {
-      // First, get all servers to find the actual version of the default server
-      const listResponse = await fetch(`http://localhost:${port}/api/mcp/v0/servers`);
-      const listBody = await listResponse.json();
-      const defaultServer = listBody.servers.find((s: any) => s.id === defaultMcpServerLogicalId);
-      expect(defaultServer).toBeDefined();
-      const actualVersion = defaultServer.version_detail.version;
-
-      const response = await fetch(`http://localhost:${port}/api/mcp/v0/servers/${defaultMcpServerLogicalId}`);
-      expect(response.status).toBe(200);
-      const body = await response.json();
-
-      expect(body.id).toBe(defaultMcpServerLogicalId);
-      expect(body).toHaveProperty('name');
-      expect(body).toHaveProperty('version_detail');
-      expect(body.version_detail.version).toBe(actualVersion);
-      // Add more assertions for package_canonical, packages, remotes if they are expected for the default server
-    });
-
-    it('GET /api/mcp/v0/servers/:id - should get specific server version if it matches', async () => {
-      const listResponse = await fetch(`http://localhost:${port}/api/mcp/v0/servers`);
-      const listBody = await listResponse.json();
-      const defaultServer = listBody.servers.find((s: any) => s.id === defaultMcpServerLogicalId);
-      expect(defaultServer).toBeDefined();
-      const actualVersion = defaultServer.version_detail.version;
-
-      const response = await fetch(
-        `http://localhost:${port}/api/mcp/v0/servers/${defaultMcpServerLogicalId}?version=${actualVersion}`,
-      );
-      expect(response.status).toBe(200);
-      const body = await response.json();
-      expect(body.id).toBe(defaultMcpServerLogicalId);
-      expect(body.version_detail.version).toBe(actualVersion);
-    });
-
-    it('GET /api/mcp/v0/servers/:id - should return 404 if specific server version does not match', async () => {
-      const nonExistentVersion = '0.0.0-nonexistent';
-      const response = await fetch(
-        `http://localhost:${port}/api/mcp/v0/servers/${defaultMcpServerLogicalId}?version=${nonExistentVersion}`,
-      );
-      expect(response.status).toBe(404);
-      const body = await response.json();
-      expect(body).toHaveProperty('error');
-      expect(body.error).toContain(`but not version '${nonExistentVersion}'`);
-    });
-
-    it('GET /api/mcp/v0/servers/:id - should return 404 for a non-existent server ID', async () => {
-      const nonExistentId = 'non-existent-server-id-12345';
-      const response = await fetch(`http://localhost:${port}/api/mcp/v0/servers/${nonExistentId}`);
-      expect(response.status).toBe(404);
-      const body = await response.json();
-      expect(body).toHaveProperty('error');
-      expect(body.error).toContain(`MCP server with ID '${nonExistentId}' not found`);
-    });
-
-    it('GET /api/mcp/v0/servers - should handle pagination (limit=1, offset=0)', async () => {
-      const response = await fetch(`http://localhost:${port}/api/mcp/v0/servers?limit=1&offset=0`);
-      expect(response.status).toBe(200);
-      const body = await response.json();
-      expect(body.servers.length).toBe(1);
-      expect(body.total_count).toBeGreaterThanOrEqual(1);
-      if (body.total_count > 1) {
-        expect(body.next).not.toBeNull();
-      } else {
-        expect(body.next).toBeNull();
-      }
-    });
-
-    it('Should be able to get lazy loaded tools', async () => {
-      const agent = await fetch(`http://localhost:${port}/api/agents/test`);
-      const agentJson = await agent.json();
-      const tools = agentJson.tools;
-
-      expect(tools).toHaveProperty('weather_fetchWeather');
-      expect(Object.keys(tools).length).toBe(4);
-    });
-  });
-});

package/integration-tests/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules"]
-}

package/integration-tests/vitest.config.ts

@@ -1,14 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    testTimeout: 60000,
-    hookTimeout: 30000,
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html'],
-    },
-  },
-});