@mastra/server 1.79.0-alpha.10 → 1.79.0-alpha.11

package/dist/server/handlers/mcp.js

@@ -1,274 +1 @@
-import { r as __exportAll } from "../../rolldown-runtime-maW3aOIk.js";
-import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
-import { n as createRoute } from "../../route-builder-BfQYtclb.js";
-import { a as listMcpServerToolsResponseSchema, c as listResourcesResponseSchema, d as mcpServerResourcePathParams, f as mcpServerToolPathParams, g as serverDetailSchema, h as readResourceResponseSchema, l as mcpServerDetailPathParams, m as readResourceBodySchema, n as executeToolResponseSchema, o as listMcpServersQuerySchema, p as mcpToolInfoSchema, r as getMcpServerDetailQuerySchema, s as listMcpServersResponseSchema, t as executeToolBodySchema, u as mcpServerIdPathParams } from "../../mcp-DzpwLXEY.js";
-import { MastraError } from "@mastra/core/error";
-//#region src/server/handlers/mcp.ts
-var mcp_exports = /* @__PURE__ */ __exportAll({
-	EXECUTE_MCP_SERVER_TOOL_ROUTE: () => EXECUTE_MCP_SERVER_TOOL_ROUTE,
-	GET_MCP_SERVER_DETAIL_ROUTE: () => GET_MCP_SERVER_DETAIL_ROUTE,
-	GET_MCP_SERVER_TOOL_DETAIL_ROUTE: () => GET_MCP_SERVER_TOOL_DETAIL_ROUTE,
-	LIST_MCP_SERVERS_ROUTE: () => LIST_MCP_SERVERS_ROUTE,
-	LIST_MCP_SERVER_RESOURCES_ROUTE: () => LIST_MCP_SERVER_RESOURCES_ROUTE,
-	LIST_MCP_SERVER_TOOLS_ROUTE: () => LIST_MCP_SERVER_TOOLS_ROUTE,
-	MCP_HTTP_TRANSPORT_ROUTE: () => MCP_HTTP_TRANSPORT_ROUTE,
-	MCP_SSE_MESSAGES_ROUTE: () => MCP_SSE_MESSAGES_ROUTE,
-	MCP_SSE_TRANSPORT_ROUTE: () => MCP_SSE_TRANSPORT_ROUTE,
-	READ_MCP_SERVER_RESOURCE_ROUTE: () => READ_MCP_SERVER_RESOURCE_ROUTE
-});
-/**
-* Only `@mastra/mcp` 1.x servers implement the standalone HTTP+SSE transport; on a
-* 2026-07-28 server the inherited `startSSE`/`startHonoSSE` throw.
-*/
-function hasSSETransport(server) {
-	return server.mcpVersion !== 2;
-}
-function transportsOf(server) {
-	return hasSSETransport(server) ? ["streamable-http", "sse"] : ["streamable-http"];
-}
-const LIST_MCP_SERVERS_ROUTE = createRoute({
-	method: "GET",
-	path: "/mcp/v0/servers",
-	responseType: "json",
-	queryParamSchema: listMcpServersQuerySchema,
-	responseSchema: listMcpServersResponseSchema,
-	summary: "List MCP servers",
-	description: "Returns a list of registered MCP servers with pagination support",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, routePrefix, page, perPage, limit, offset }) => {
-		if (!mastra || typeof mastra.listMCPServers !== "function") throw new HTTPException(500, { message: "Mastra instance or listMCPServers method not available" });
-		const servers = mastra.listMCPServers();
-		if (!servers) return {
-			servers: [],
-			total_count: 0,
-			next: null
-		};
-		const serverList = Object.values(servers);
-		const totalCount = serverList.length;
-		const useLegacyFormat = (limit !== void 0 || offset !== void 0) && page === void 0 && perPage === void 0;
-		const finalPerPage = perPage ?? limit;
-		let finalPage = page;
-		if (finalPage === void 0 && offset !== void 0 && finalPerPage !== void 0 && finalPerPage > 0) finalPage = Math.floor(offset / finalPerPage);
-		const actualOffset = finalPage !== void 0 && finalPerPage !== void 0 ? finalPage * finalPerPage : 0;
-		let paginatedServers = serverList;
-		let nextUrl = null;
-		if (finalPerPage !== void 0) {
-			paginatedServers = serverList.slice(actualOffset, actualOffset + finalPerPage);
-			if (actualOffset + finalPerPage < totalCount) {
-				const nextPage = (finalPage ?? 0) + 1;
-				const prefix = routePrefix ?? "";
-				if (useLegacyFormat) nextUrl = `${prefix}/mcp/v0/servers?limit=${finalPerPage}&offset=${actualOffset + finalPerPage}`;
-				else nextUrl = `${prefix}/mcp/v0/servers?perPage=${finalPerPage}&page=${nextPage}`;
-			}
-		}
-		return {
-			servers: paginatedServers.map((server) => ({
-				...server.getServerInfo(),
-				transports: transportsOf(server)
-			})),
-			total_count: totalCount,
-			next: nextUrl
-		};
-	}
-});
-const GET_MCP_SERVER_DETAIL_ROUTE = createRoute({
-	method: "GET",
-	path: "/mcp/v0/servers/:id",
-	responseType: "json",
-	pathParamSchema: mcpServerDetailPathParams,
-	queryParamSchema: getMcpServerDetailQuerySchema,
-	responseSchema: serverDetailSchema,
-	summary: "Get MCP server details",
-	description: "Returns detailed information about a specific MCP server",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, id, version }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(id);
-		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${id}' not found` });
-		const serverDetail = {
-			...server.getServerDetail(),
-			transports: transportsOf(server)
-		};
-		if (version && serverDetail.version_detail.version !== version) throw new HTTPException(404, { message: `MCP server with ID '${id}' found, but not version '${version}'. Available version: ${serverDetail.version_detail.version}` });
-		return serverDetail;
-	}
-});
-const LIST_MCP_SERVER_TOOLS_ROUTE = createRoute({
-	method: "GET",
-	path: "/mcp/:serverId/tools",
-	responseType: "json",
-	pathParamSchema: mcpServerIdPathParams,
-	responseSchema: listMcpServerToolsResponseSchema,
-	summary: "List MCP server tools",
-	description: "Returns a list of tools available on the specified MCP server",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, serverId, requestContext }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(serverId);
-		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
-		if (typeof server.getToolListInfo !== "function") throw new HTTPException(501, { message: `Server '${serverId}' cannot list tools in this way.` });
-		return await server.getToolListInfo(requestContext);
-	}
-});
-const GET_MCP_SERVER_TOOL_DETAIL_ROUTE = createRoute({
-	method: "GET",
-	path: "/mcp/:serverId/tools/:toolId",
-	responseType: "json",
-	pathParamSchema: mcpServerToolPathParams,
-	responseSchema: mcpToolInfoSchema,
-	summary: "Get MCP server tool details",
-	description: "Returns detailed information about a specific tool on the MCP server",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, serverId, toolId }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(serverId);
-		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
-		if (typeof server.getToolInfo !== "function") throw new HTTPException(501, { message: `Server '${serverId}' cannot provide tool details in this way.` });
-		const toolInfo = await server.getToolInfo(toolId);
-		if (!toolInfo) throw new HTTPException(404, { message: `Tool with ID '${toolId}' not found on MCP server '${serverId}'` });
-		return toolInfo;
-	}
-});
-const EXECUTE_MCP_SERVER_TOOL_ROUTE = createRoute({
-	method: "POST",
-	path: "/mcp/:serverId/tools/:toolId/execute",
-	responseType: "json",
-	pathParamSchema: mcpServerToolPathParams,
-	bodySchema: executeToolBodySchema,
-	responseSchema: executeToolResponseSchema,
-	summary: "Execute MCP server tool",
-	description: "Executes a tool on the specified MCP server with the provided arguments",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, serverId, toolId, data, resumeData, suspendPayload, requestContext }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(serverId);
-		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
-		if (typeof server.executeTool !== "function") throw new HTTPException(501, { message: `Server '${serverId}' cannot execute tools in this way.` });
-		if (server.mcpVersion === 2) {
-			let execution;
-			try {
-				execution = await server.executeTool(toolId, data, {
-					requestContext,
-					resumeData,
-					suspendPayload
-				});
-			} catch (error) {
-				if (error instanceof MastraError && error.id === "MCP_SERVER_TOOL_INVALID_INPUT") throw new HTTPException(400, {
-					message: error.message,
-					cause: error
-				});
-				throw error;
-			}
-			if (execution.status === "suspended") return {
-				status: "suspended",
-				suspendPayload: execution.suspendPayload,
-				resumeSchema: execution.resumeSchema
-			};
-			return { result: execution.output };
-		}
-		return { result: await server.executeTool(toolId, data, { requestContext }) };
-	}
-});
-const LIST_MCP_SERVER_RESOURCES_ROUTE = createRoute({
-	method: "GET",
-	path: "/mcp/:serverId/resources",
-	responseType: "json",
-	pathParamSchema: mcpServerResourcePathParams,
-	responseSchema: listResourcesResponseSchema,
-	summary: "List MCP server resources",
-	description: "Returns a list of resources available on the MCP server, including ui:// app resources",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, serverId }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(serverId);
-		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
-		if (typeof server.listResources !== "function") return { resources: [] };
-		return server.listResources();
-	}
-});
-const READ_MCP_SERVER_RESOURCE_ROUTE = createRoute({
-	method: "POST",
-	path: "/mcp/:serverId/resources/read",
-	responseType: "json",
-	pathParamSchema: mcpServerResourcePathParams,
-	bodySchema: readResourceBodySchema,
-	responseSchema: readResourceResponseSchema,
-	summary: "Read MCP server resource content",
-	description: "Reads the content of a resource by URI, used for rendering MCP App ui:// resources",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, serverId, uri }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(serverId);
-		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
-		if (typeof server.readResource !== "function") throw new HTTPException(501, { message: `Server '${serverId}' does not support reading resources` });
-		try {
-			return await server.readResource(uri);
-		} catch (error) {
-			const message = error instanceof Error ? error.message : String(error);
-			if (message.includes("not found") || message.includes("not configured")) throw new HTTPException(404, { message: `Resource '${uri}' not found on server '${serverId}'` });
-			throw error;
-		}
-	}
-});
-const MCP_HTTP_TRANSPORT_ROUTE = createRoute({
-	method: "ALL",
-	path: "/mcp/:serverId/mcp",
-	responseType: "mcp-http",
-	pathParamSchema: mcpServerIdPathParams,
-	summary: "MCP HTTP Transport",
-	description: "Streamable HTTP transport endpoint for MCP protocol communication",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, serverId }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(serverId);
-		if (!server) throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });
-		return {
-			server,
-			httpPath: `/mcp/${serverId}/mcp`
-		};
-	}
-});
-const MCP_SSE_TRANSPORT_ROUTE = createRoute({
-	method: "ALL",
-	path: "/mcp/:serverId/sse",
-	responseType: "mcp-sse",
-	pathParamSchema: mcpServerIdPathParams,
-	summary: "MCP SSE Transport",
-	description: "SSE transport endpoint for MCP protocol communication",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: async ({ mastra, serverId }) => {
-		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
-		const server = mastra.getMCPServerById(serverId);
-		if (!server) throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });
-		if (!hasSSETransport(server)) throw new HTTPException(404, { message: "Legacy SSE transport is unavailable for MCP v2 servers" });
-		return {
-			server,
-			ssePath: `/mcp/${serverId}/sse`,
-			messagePath: `/mcp/${serverId}/messages`
-		};
-	}
-});
-const MCP_SSE_MESSAGES_ROUTE = createRoute({
-	method: "POST",
-	path: "/mcp/:serverId/messages",
-	responseType: "mcp-sse",
-	pathParamSchema: mcpServerIdPathParams,
-	summary: "MCP SSE Messages",
-	description: "Message endpoint for SSE transport (posts messages to active SSE streams)",
-	tags: ["MCP"],
-	requiresAuth: true,
-	handler: MCP_SSE_TRANSPORT_ROUTE.handler
-});
-//#endregion
-export { EXECUTE_MCP_SERVER_TOOL_ROUTE, GET_MCP_SERVER_DETAIL_ROUTE, GET_MCP_SERVER_TOOL_DETAIL_ROUTE, LIST_MCP_SERVERS_ROUTE, LIST_MCP_SERVER_RESOURCES_ROUTE, LIST_MCP_SERVER_TOOLS_ROUTE, MCP_HTTP_TRANSPORT_ROUTE, MCP_SSE_MESSAGES_ROUTE, MCP_SSE_TRANSPORT_ROUTE, READ_MCP_SERVER_RESOURCE_ROUTE, mcp_exports as t };
-
-//# sourceMappingURL=mcp.js.map
+export { t as EXECUTE_MCP_SERVER_TOOL_ROUTE, n as GET_MCP_SERVER_DETAIL_ROUTE, r as GET_MCP_SERVER_TOOL_DETAIL_ROUTE, i as LIST_MCP_SERVERS_ROUTE, a as LIST_MCP_SERVER_RESOURCES_ROUTE, o as LIST_MCP_SERVER_TOOLS_ROUTE, s as MCP_HTTP_TRANSPORT_ROUTE, c as MCP_SSE_MESSAGES_ROUTE, l as MCP_SSE_TRANSPORT_ROUTE, u as READ_MCP_SERVER_RESOURCE_ROUTE } from "../../mcp-BTdLh6E_.js";