Support an HTTP GET handler for HttpServletStatelessServerTransport

Currently, `HttpServletStatelessServerTransport` always returns
`SC_METHOD_NOT_ALLOWED` for GET. With this change, consumers of the
library can implement their own GET handler so that they can implement
the Session semantics of the MCP protocol.

Author: Randgalt

mcp-core/src/main/java/io/modelcontextprotocol/server/transport/HttpServletStatelessServerTransport.java

@@ -4,16 +4,8 @@
 
 package io.modelcontextprotocol.server.transport;
 
-import java.io.BufferedReader;
-import java.io.IOException;
-import java.io.PrintWriter;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import io.modelcontextprotocol.json.McpJsonMapper;
-
 import io.modelcontextprotocol.common.McpTransportContext;
+import io.modelcontextprotocol.json.McpJsonMapper;
 import io.modelcontextprotocol.server.McpStatelessServerHandler;
 import io.modelcontextprotocol.server.McpTransportContextExtractor;
 import io.modelcontextprotocol.spec.McpError;
@@ -25,8 +17,14 @@
 import jakarta.servlet.http.HttpServlet;
 import jakarta.servlet.http.HttpServletRequest;
 import jakarta.servlet.http.HttpServletResponse;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 import reactor.core.publisher.Mono;
 
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.PrintWriter;
+
 /**
  * Implementation of an HttpServlet based {@link McpStatelessServerTransport}.
  *
@@ -58,6 +56,9 @@ public class HttpServletStatelessServerTransport extends HttpServlet implements
 
 	private volatile boolean isClosing = false;
 
+	private volatile GetHandler getHandler = (request, response) -> response
+		.sendError(HttpServletResponse.SC_METHOD_NOT_ALLOWED);
+
 	private HttpServletStatelessServerTransport(McpJsonMapper jsonMapper, String mcpEndpoint,
 			McpTransportContextExtractor<HttpServletRequest> contextExtractor) {
 		Assert.notNull(jsonMapper, "jsonMapper must not be null");
@@ -79,6 +80,18 @@ public Mono<Void> closeGracefully() {
 		return Mono.fromRunnable(() -> this.isClosing = true);
 	}
 
+	public void setGetHandler(GetHandler getHandler) {
+		Assert.notNull(getHandler, "getHandler must not be null");
+
+		this.getHandler = getHandler;
+	}
+
+	public interface GetHandler {
+
+		void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException;
+
+	}
+
 	/**
 	 * Handles GET requests - returns 405 METHOD NOT ALLOWED as stateless transport
 	 * doesn't support GET requests.
@@ -97,7 +110,7 @@ protected void doGet(HttpServletRequest request, HttpServletResponse response)
 			return;
 		}
 
-		response.sendError(HttpServletResponse.SC_METHOD_NOT_ALLOWED);
+		getHandler.doGet(request, response);
 	}
 
 	/**

mcp-spring/mcp-spring-webflux/src/main/java/io/modelcontextprotocol/server/transport/WebFluxStatelessServerTransport.java

@@ -46,6 +46,8 @@ public class WebFluxStatelessServerTransport implements McpStatelessServerTransp
 
 	private volatile boolean isClosing = false;
 
+	private volatile GetHandler getHandler = (request) -> ServerResponse.status(HttpStatus.METHOD_NOT_ALLOWED).build();
+
 	private WebFluxStatelessServerTransport(McpJsonMapper jsonMapper, String mcpEndpoint,
 			McpTransportContextExtractor<ServerRequest> contextExtractor) {
 		Assert.notNull(jsonMapper, "jsonMapper must not be null");
@@ -87,8 +89,20 @@ public RouterFunction<?> getRouterFunction() {
 		return this.routerFunction;
 	}
 
+	public interface GetHandler {
+
+		Mono<ServerResponse> doGet(ServerRequest request);
+
+	}
+
+	public void setGetHandler(GetHandler getHandler) {
+		Assert.notNull(getHandler, "getHandler must not be null");
+
+		this.getHandler = getHandler;
+	}
+
 	private Mono<ServerResponse> handleGet(ServerRequest request) {
-		return ServerResponse.status(HttpStatus.METHOD_NOT_ALLOWED).build();
+		return getHandler.doGet(request);
 	}
 
 	private Mono<ServerResponse> handlePost(ServerRequest request) {

mcp-spring/mcp-spring-webmvc/src/main/java/io/modelcontextprotocol/server/transport/WebMvcStatelessServerTransport.java

@@ -50,6 +50,8 @@ public class WebMvcStatelessServerTransport implements McpStatelessServerTranspo
 
 	private volatile boolean isClosing = false;
 
+	private volatile GetHandler getHandler = (request) -> ServerResponse.status(HttpStatus.METHOD_NOT_ALLOWED).build();
+
 	private WebMvcStatelessServerTransport(McpJsonMapper jsonMapper, String mcpEndpoint,
 			McpTransportContextExtractor<ServerRequest> contextExtractor) {
 		Assert.notNull(jsonMapper, "jsonMapper must not be null");
@@ -91,8 +93,20 @@ public RouterFunction<ServerResponse> getRouterFunction() {
 		return this.routerFunction;
 	}
 
+	public interface GetHandler {
+
+		ServerResponse doGet(ServerRequest request);
+
+	}
+
+	public void setGetHandler(GetHandler getHandler) {
+		Assert.notNull(getHandler, "getHandler must not be null");
+
+		this.getHandler = getHandler;
+	}
+
 	private ServerResponse handleGet(ServerRequest request) {
-		return ServerResponse.status(HttpStatus.METHOD_NOT_ALLOWED).build();
+		return getHandler.doGet(request);
 	}
 
 	private ServerResponse handlePost(ServerRequest request) {