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	jsonMapper(McpJsonMapper jsonMapper)	Sets the JsonMapper to use for JSON serialization/deserialization of MCP messages.
HttpServletStatelessServerTransport.Builder	messageEndpoint(String messageEndpoint)	Sets the endpoint URI where clients should send their JSON-RPC messages.
HttpServletStatelessServerTransport.Builder	securityValidator(ServerTransportSecurityValidator securityValidator)	Sets the security validator for validating HTTP requests.

Methods inherited from class java.lang.Object

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

Method Details

jsonMapper

public HttpServletStatelessServerTransport.Builder jsonMapper(McpJsonMapper jsonMapper)

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

Parameters:

jsonMapper - The JsonMapper instance. Must not be null.

Returns:

this builder instance

Throws:

IllegalArgumentException - if jsonMapper 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

securityValidator

public HttpServletStatelessServerTransport.Builder securityValidator(ServerTransportSecurityValidator securityValidator)

Sets the security validator for validating HTTP requests.

Parameters:

securityValidator - The security validator to use. Must not be null.

Returns:

this builder instance

Throws:

IllegalArgumentException - if securityValidator 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