Server: Added Streamable HTTP & Bump MCP SDK version

package.json

@@ -22,7 +22,7 @@
     "lib"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.6.1",
+    "@modelcontextprotocol/sdk": "^1.13.2",
     "commander": "^14.0.0",
     "express": "^5.1.0",
     "fast-xml-parser": "^5.0.9",

src/index.ts

@@ -1,34 +1,165 @@
 #!/usr/bin/env node
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { randomUUID } from "node:crypto";
 import { createMcpServer, getAgentVersion } from "./server";
 import { error } from "./logger";
 import express from "express";
 import { program } from "commander";
 
-const startSseServer = async (port: number) => {
+const startHttpServer = async (port: number) => {
 	const app = express();
-	const server = createMcpServer();
+	app.use(express.json());
 
-	let transport: SSEServerTransport | null = null;
+	// Store transports by session ID to support both transport types
+	const transports: Record<string, StreamableHTTPServerTransport | SSEServerTransport> = {};
 
-	app.post("/mcp", (req, res) => {
-		if (transport) {
-			transport.handlePostMessage(req, res);
+	// =============================================================================
+	// STREAMABLE HTTP TRANSPORT (Protocol version: 2025-03-26) - Current implementation
+	// =============================================================================
+	app.all("/mcp", async (req, res) => {
+		try {
+			// Check for existing session ID
+			const sessionId = req.headers["mcp-session-id"] as string;
+			let transport: StreamableHTTPServerTransport;
+
+			if (sessionId && transports[sessionId]) {
+				// Check if the transport is of the correct type
+				const existingTransport = transports[sessionId];
+				if (existingTransport instanceof StreamableHTTPServerTransport) {
+					// Reuse existing transport
+					transport = existingTransport;
+				} else {
+					// Transport exists but is not a StreamableHTTPServerTransport
+					res.status(400).json({
+						jsonrpc: "2.0",
+						error: {
+							code: -32000,
+							message: "Bad Request: Session exists but uses a different transport protocol",
+						},
+						id: null,
+					});
+					return;
+				}
+			} else if (!sessionId && req.method === "POST" && isInitializeRequest(req.body)) {
+				// Create new transport for initialization
+				transport = new StreamableHTTPServerTransport({
+					sessionIdGenerator: () => randomUUID(),
+					onsessioninitialized: (sessionId: string) => {
+						// Store the transport by session ID when session is initialized
+						console.log(`StreamableHTTP session initialized with ID: ${sessionId}`);
+						transports[sessionId] = transport;
+					}
+				});
+
+				// Set up onclose handler to clean up transport when closed
+				transport.onclose = () => {
+					const sid = transport.sessionId;
+					if (sid && transports[sid]) {
+						console.log(`Transport closed for session ${sid}, removing from transports map`);
+						delete transports[sid];
+					}
+				};
+
+				// Connect the transport to the MCP server
+				const server = createMcpServer();
+				await server.connect(transport);
+			} else {
+				// Invalid request - no session ID or not initialization request
+				res.status(400).json({
+					jsonrpc: "2.0",
+					error: {
+						code: -32000,
+						message: "Bad Request: No valid session ID provided",
+					},
+					id: null,
+				});
+				return;
+			}
+
+			// Handle the request with the transport
+			await transport.handleRequest(req, res, req.body);
+		} catch (error: any) {
+			console.error("Error handling MCP request:", error);
+			if (!res.headersSent) {
+				res.status(500).json({
+					jsonrpc: "2.0",
+					error: {
+						code: -32603,
+						message: "Internal server error",
+					},
+					id: null,
+				});
+			}
 		}
 	});
 
-	app.get("/mcp", (req, res) => {
-		if (transport) {
-			transport.close();
+	// =============================================================================
+	// SSE TRANSPORT (Protocol version: 2024-11-05) - Backward compatibility
+	// =============================================================================
+	app.get("/sse", async (req, res) => {
+		console.log("Received GET request to /sse (SSE transport)");
+		try {
+			const transport = new SSEServerTransport("/messages", res);
+			transports[transport.sessionId] = transport;
+
+			res.on("close", () => {
+				delete transports[transport.sessionId];
+			});
+
+			const server = createMcpServer();
+			await server.connect(transport);
+		} catch (error: any) {
+			console.error("Error setting up SSE transport:", error);
+			if (!res.headersSent) {
+				res.status(500).send("Failed to establish SSE connection");
+			}
 		}
+	});
+
+	app.post("/messages", async (req, res) => {
+		try {
+			const sessionId = req.query.sessionId as string;
+			if (!sessionId) {
+				res.status(400).send("Missing sessionId query parameter");
+				return;
+			}
 
-		transport = new SSEServerTransport("/mcp", res);
-		server.connect(transport);
+			const existingTransport = transports[sessionId];
+			if (!existingTransport) {
+				res.status(400).send("No transport found for sessionId");
+				return;
+			}
+
+			if (existingTransport instanceof SSEServerTransport) {
+				// Handle the POST message with SSE transport
+				await existingTransport.handlePostMessage(req, res, req.body);
+			} else {
+				// Transport exists but is not a SSEServerTransport
+				res.status(400).json({
+					jsonrpc: "2.0",
+					error: {
+						code: -32000,
+						message: "Bad Request: Session exists but uses a different transport protocol",
+					},
+					id: null,
+				});
+			}
+		} catch (error: any) {
+			console.error("Error handling SSE message:", error);
+			if (!res.headersSent) {
+				res.status(500).send("Internal server error");
+			}
+		}
 	});
 
 	app.listen(port, () => {
-		error(`mobile-mcp ${getAgentVersion()} sse server listening on http://localhost:${port}/mcp`);
+		error(`mobile-mcp ${getAgentVersion()} server listening on http://localhost:${port}`);
+		error(`Supported transports:`);
+		error(`  - Streamable HTTP: http://localhost:${port}/mcp`);
+		error(`  - SSE: http://localhost:${port}/sse (stream) + http://localhost:${port}/messages (requests)`);
 	});
 };
 
@@ -50,14 +181,14 @@ const startStdioServer = async () => {
 const main = async () => {
 	program
 		.version(getAgentVersion())
-		.option("--port <port>", "Start SSE server on this port")
+		.option("--port <port>", "Start HTTP server on this port (supports both Streamable HTTP and SSE transports)")
 		.option("--stdio", "Start stdio server (default)")
 		.parse(process.argv);
 
 	const options = program.opts();
 
 	if (options.port) {
-		await startSseServer(+options.port);
+		await startHttpServer(+options.port);
 	} else {
 		await startStdioServer();
 	}

src/server.ts

@@ -208,6 +208,10 @@ export const createMcpServer = (): McpServer => {
 		async ({ device, deviceType }) => {
 			switch (deviceType) {
 				case "simulator":
+					// iOS Simulator is only supported on macOS. Avoid calling xcrun on other platforms.
+					if (process.platform !== "darwin") {
+						throw new ActionableError("iOS Simulator is only available on macOS. Please select an Android device or run on macOS.");
+					}
 					robot = simulatorManager.getSimulator(device);
 					break;
 				case "ios":
@@ -243,6 +247,10 @@ export const createMcpServer = (): McpServer => {
 		},
 		async ({ packageName }) => {
 			requireRobot();
+			// Defensive guard: if a simulator robot was somehow selected on non-macOS, return a helpful error
+			if (process.platform !== "darwin" && robot && robot.constructor && robot.constructor.name === "Simctl") {
+				throw new ActionableError("iOS Simulator operations are not available on this OS. Please select an Android device using mobile_use_device.");
+			}
 			await robot!.launchApp(packageName);
 			return `Launched app ${packageName}`;
 		}