@mastra/mcp 0.4.0-alpha.8 → 0.4.0-alpha.9

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/mcp@0.4.0-alpha.8 build /home/runner/work/mastra/mastra/packages/mcp
+> @mastra/mcp@0.4.0-alpha.9 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 14746ms
+TSC ⚡️ Build success in 14236ms
 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 10120ms
+DTS ⚡️ Build success in 13685ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 129.12 KB
-CJS ⚡️ Build success in 3335ms
-ESM dist/index.js 129.07 KB
-ESM ⚡️ Build success in 3335ms
+ESM dist/index.js 199.82 KB
+ESM ⚡️ Build success in 3988ms
+CJS dist/index.cjs 200.48 KB
+CJS ⚡️ Build success in 3974ms

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp
 
+## 0.4.0-alpha.9
+
+### Patch Changes
+
+- 0a033fa: Adds MCPServer component
+- Updated dependencies [000a6d4]
+- Updated dependencies [ed2f549]
+- Updated dependencies [c0f22b4]
+- Updated dependencies [0a033fa]
+- Updated dependencies [9c26508]
+- Updated dependencies [0f4eae3]
+- Updated dependencies [16a8648]
+  - @mastra/core@0.9.0-alpha.8
+
 ## 0.4.0-alpha.8
 
 ### Patch Changes

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

@@ -4,7 +4,32 @@ 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 { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 import type { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Tool } from '@mastra/core/tools';
+import { ToolExecutionContext } from '@mastra/core';
+import type { ToolsInput } from '@mastra/core/agent';
+import { z } from 'zod';
+
+declare type ConvertedTool = {
+    name: string;
+    description?: string;
+    inputSchema: any;
+    zodSchema: z.ZodTypeAny;
+    execute: any;
+};
+
+export declare function createLogger(server?: Server): Logger;
+
+export declare interface Logger {
+    info: (message: string, data?: any) => Promise<void>;
+    warning: (message: string, data?: any) => Promise<void>;
+    error: (message: string, error?: any) => Promise<void>;
+    debug: (message: string, data?: any) => Promise<void>;
+}
+
+export declare const logger: Logger;
 
 export { LoggingLevel }
 export { LoggingLevel as LoggingLevel_alias_1 }
@@ -88,6 +113,73 @@ declare interface MCPConfigurationOptions {
 export { MCPConfigurationOptions }
 export { MCPConfigurationOptions as MCPConfigurationOptions_alias_1 }
 
+declare class MCPServer {
+    private server;
+    private convertedTools;
+    private stdioTransport?;
+    private sseTransport?;
+    /**
+     * Get the current stdio transport.
+     */
+    getStdioTransport(): StdioServerTransport | undefined;
+    /**
+     * Get the current SSE transport.
+     */
+    getSseTransport(): SSEServerTransport | undefined;
+    /**
+     * Get a read-only view of the registered tools (for testing/introspection).
+     */
+    tools(): Readonly<Record<string, ConvertedTool>>;
+    /**
+     * Construct a new MCPServer instance.
+     * @param opts.name - Server name
+     * @param opts.version - Server version
+     * @param opts.tools - Tool definitions to register
+     */
+    constructor({ name, version, tools }: {
+        name: string;
+        version: string;
+        tools: ToolsInput;
+    });
+    /**
+     * Convert and validate all provided tools, logging registration status.
+     * @param tools Tool definitions
+     * @returns Converted tools registry
+     */
+    private convertTools;
+    /**
+     * Register the ListTools handler for listing all available tools.
+     */
+    private registerListToolsHandler;
+    /**
+     * Register the CallTool handler for executing a tool by name.
+     */
+    private registerCallToolHandler;
+    /**
+     * Start the MCP server using stdio transport (for Windsurf integration).
+     */
+    startStdio(): Promise<void>;
+    /**
+     * Handles MCP-over-SSE protocol for user-provided HTTP servers.
+     * Call this from your HTTP server for both the SSE and message endpoints.
+     *
+     * @param url Parsed URL of the incoming request
+     * @param ssePath Path for establishing the SSE connection (e.g. '/sse')
+     * @param messagePath Path for POSTing client messages (e.g. '/message')
+     * @param req Incoming HTTP request
+     * @param res HTTP response (must support .write/.end)
+     */
+    startSSE({ url, ssePath, messagePath, req, res, }: {
+        url: URL;
+        ssePath: string;
+        messagePath: string;
+        req: any;
+        res: any;
+    }): Promise<void>;
+}
+export { MCPServer }
+export { MCPServer as MCPServer_alias_1 }
+
 export declare const server: Server<{
     method: string;
     params?: {
@@ -140,4 +232,44 @@ declare type SSEClientParameters = {
     url: URL;
 } & SSEClientTransportOptions;
 
+export declare const weatherTool: Tool<z.ZodObject<{
+location: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+location: string;
+}, {
+location: string;
+}>, z.ZodObject<{
+temperature: z.ZodNumber;
+feelsLike: z.ZodNumber;
+humidity: z.ZodNumber;
+windSpeed: z.ZodNumber;
+windGust: z.ZodNumber;
+conditions: z.ZodString;
+location: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+location: string;
+temperature: number;
+feelsLike: number;
+humidity: number;
+windSpeed: number;
+windGust: number;
+conditions: string;
+}, {
+location: string;
+temperature: number;
+feelsLike: number;
+humidity: number;
+windSpeed: number;
+windGust: number;
+conditions: string;
+}>, ToolExecutionContext<z.ZodObject<{
+location: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+location: string;
+}, {
+location: string;
+}>>>;
+
+export declare const writeErrorLog: (message: string, data?: any) => void;
+
 export { }

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

@@ -4,7 +4,32 @@ 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 { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 import type { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Tool } from '@mastra/core/tools';
+import { ToolExecutionContext } from '@mastra/core';
+import type { ToolsInput } from '@mastra/core/agent';
+import { z } from 'zod';
+
+declare type ConvertedTool = {
+    name: string;
+    description?: string;
+    inputSchema: any;
+    zodSchema: z.ZodTypeAny;
+    execute: any;
+};
+
+export declare function createLogger(server?: Server): Logger;
+
+export declare interface Logger {
+    info: (message: string, data?: any) => Promise<void>;
+    warning: (message: string, data?: any) => Promise<void>;
+    error: (message: string, error?: any) => Promise<void>;
+    debug: (message: string, data?: any) => Promise<void>;
+}
+
+export declare const logger: Logger;
 
 export { LoggingLevel }
 export { LoggingLevel as LoggingLevel_alias_1 }
@@ -88,6 +113,73 @@ declare interface MCPConfigurationOptions {
 export { MCPConfigurationOptions }
 export { MCPConfigurationOptions as MCPConfigurationOptions_alias_1 }
 
+declare class MCPServer {
+    private server;
+    private convertedTools;
+    private stdioTransport?;
+    private sseTransport?;
+    /**
+     * Get the current stdio transport.
+     */
+    getStdioTransport(): StdioServerTransport | undefined;
+    /**
+     * Get the current SSE transport.
+     */
+    getSseTransport(): SSEServerTransport | undefined;
+    /**
+     * Get a read-only view of the registered tools (for testing/introspection).
+     */
+    tools(): Readonly<Record<string, ConvertedTool>>;
+    /**
+     * Construct a new MCPServer instance.
+     * @param opts.name - Server name
+     * @param opts.version - Server version
+     * @param opts.tools - Tool definitions to register
+     */
+    constructor({ name, version, tools }: {
+        name: string;
+        version: string;
+        tools: ToolsInput;
+    });
+    /**
+     * Convert and validate all provided tools, logging registration status.
+     * @param tools Tool definitions
+     * @returns Converted tools registry
+     */
+    private convertTools;
+    /**
+     * Register the ListTools handler for listing all available tools.
+     */
+    private registerListToolsHandler;
+    /**
+     * Register the CallTool handler for executing a tool by name.
+     */
+    private registerCallToolHandler;
+    /**
+     * Start the MCP server using stdio transport (for Windsurf integration).
+     */
+    startStdio(): Promise<void>;
+    /**
+     * Handles MCP-over-SSE protocol for user-provided HTTP servers.
+     * Call this from your HTTP server for both the SSE and message endpoints.
+     *
+     * @param url Parsed URL of the incoming request
+     * @param ssePath Path for establishing the SSE connection (e.g. '/sse')
+     * @param messagePath Path for POSTing client messages (e.g. '/message')
+     * @param req Incoming HTTP request
+     * @param res HTTP response (must support .write/.end)
+     */
+    startSSE({ url, ssePath, messagePath, req, res, }: {
+        url: URL;
+        ssePath: string;
+        messagePath: string;
+        req: any;
+        res: any;
+    }): Promise<void>;
+}
+export { MCPServer }
+export { MCPServer as MCPServer_alias_1 }
+
 export declare const server: Server<{
     method: string;
     params?: {
@@ -140,4 +232,44 @@ declare type SSEClientParameters = {
     url: URL;
 } & SSEClientTransportOptions;
 
+export declare const weatherTool: Tool<z.ZodObject<{
+location: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+location: string;
+}, {
+location: string;
+}>, z.ZodObject<{
+temperature: z.ZodNumber;
+feelsLike: z.ZodNumber;
+humidity: z.ZodNumber;
+windSpeed: z.ZodNumber;
+windGust: z.ZodNumber;
+conditions: z.ZodString;
+location: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+location: string;
+temperature: number;
+feelsLike: number;
+humidity: number;
+windSpeed: number;
+windGust: number;
+conditions: string;
+}, {
+location: string;
+temperature: number;
+feelsLike: number;
+humidity: number;
+windSpeed: number;
+windGust: number;
+conditions: string;
+}>, ToolExecutionContext<z.ZodObject<{
+location: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+location: string;
+}, {
+location: string;
+}>>>;
+
+export declare const writeErrorLog: (message: string, data?: any) => void;
+
 export { }