Module io.modelcontextprotocol.sdk.mcp

Package io.modelcontextprotocol.server.transport

Class HttpServletStatelessServerTransport.Builder

java.lang.Object

io.modelcontextprotocol.server.transport.HttpServletStatelessServerTransport.Builder

Enclosing class:

HttpServletStatelessServerTransport

public static class HttpServletStatelessServerTransport.Builder
extends Object

Builder for creating instances of HttpServletStatelessServerTransport.

This builder provides a fluent API for configuring and creating instances of HttpServletStatelessServerTransport with custom settings.

Method Summary

Modifier and Type	Method	Description
HttpServletStatelessServerTransport	build()	Builds a new instance of HttpServletStatelessServerTransport with the configured settings.
HttpServletStatelessServerTransport.Builder	contextExtractor(McpTransportContextExtractor<jakarta.servlet.http.HttpServletRequest> contextExtractor)	Sets the context extractor that allows providing the MCP feature implementations to inspect HTTP transport level metadata that was present at HTTP request processing time.
HttpServletStatelessServerTransport.Builder	messageEndpoint(String messageEndpoint)	Sets the endpoint URI where clients should send their JSON-RPC messages.
HttpServletStatelessServerTransport.Builder	objectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)	Sets the ObjectMapper to use for JSON serialization/deserialization of MCP messages.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

objectMapper

public HttpServletStatelessServerTransport.Builder objectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Sets the ObjectMapper to use for JSON serialization/deserialization of MCP messages.

Parameters:

objectMapper - The ObjectMapper instance. Must not be null.

Returns:

this builder instance

Throws:

IllegalArgumentException - if objectMapper is null

messageEndpoint

public HttpServletStatelessServerTransport.Builder messageEndpoint(String messageEndpoint)

Sets the endpoint URI where clients should send their JSON-RPC messages.

Parameters:

messageEndpoint - The message endpoint URI. Must not be null.

Returns:

this builder instance

Throws:

IllegalArgumentException - if messageEndpoint is null

contextExtractor

public HttpServletStatelessServerTransport.Builder contextExtractor(McpTransportContextExtractor<jakarta.servlet.http.HttpServletRequest> contextExtractor)

Sets the context extractor that allows providing the MCP feature implementations to inspect HTTP transport level metadata that was present at HTTP request processing time. This allows to extract custom headers and other useful data for use during execution later on in the process.

Parameters:

contextExtractor - The contextExtractor to fill in a McpTransportContext.

Returns:

this builder instance

Throws:

IllegalArgumentException - if contextExtractor is null

build

public HttpServletStatelessServerTransport build()

Builds a new instance of HttpServletStatelessServerTransport with the configured settings.

Returns:

A new HttpServletStatelessServerTransport instance

Throws:

IllegalStateException - if required parameters are not set