Interface McpServer

All Superinterfaces:

AutoCloseable

public interface McpServer
extends AutoCloseable

Contract for MCP server implementations that are designed to be managed by a Soklet instance.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	McpServer.Builder	Builder for McpServer instances.
static interface	McpServer.RequestHandler	Request callback used by Soklet to hand transport requests to an initialized MCP server.

Method Summary

Modifier and Type	Method	Description
default void	close()
static @NonNull McpServer	fromPort(@NonNull Integer port)	Creates a default MCP server bound to the given port.
@NonNull McpCorsAuthorizer	getCorsAuthorizer()	Provides the MCP CORS authorizer.
@NonNull McpHandlerResolver	getHandlerResolver()	Provides the MCP handler resolver.
@NonNull IdGenerator<String>	getIdGenerator()	Provides the generator used for MCP session IDs.
@NonNull McpRequestAdmissionPolicy	getRequestAdmissionPolicy()	Provides the request admission policy.
@NonNull McpRequestInterceptor	getRequestInterceptor()	Provides the request interceptor.
@NonNull McpResponseMarshaler	getResponseMarshaler()	Provides the response marshaler used for tool structured content.
@NonNull McpSessionStore	getSessionStore()	Provides the session store.
void	initialize(@NonNull SokletConfig sokletConfig, @NonNull McpServer.RequestHandler requestHandler)	Initializes the server with Soklet-owned infrastructure.
@NonNull Boolean	isStarted()	Indicates whether the server has been started.
void	start()	Starts the MCP server.
void	stop()	Stops the MCP server.
static @NonNull McpServer.Builder	withPort(@NonNull Integer port)	Acquires a builder configured with the given port.

Method Details

start

void start()

Starts the MCP server.

stop

void stop()

Stops the MCP server.

isStarted

@NonNull Boolean isStarted()

Indicates whether the server has been started.

Returns:

true if the server is started

initialize

void initialize(@NonNull SokletConfig sokletConfig,
 @NonNull McpServer.RequestHandler requestHandler)

Initializes the server with Soklet-owned infrastructure.

Parameters:

sokletConfig - the owning Soklet configuration

requestHandler - the request handler callback Soklet will invoke for MCP requests

getHandlerResolver

@NonNull McpHandlerResolver getHandlerResolver()

Provides the MCP handler resolver.

Returns:

the handler resolver

getRequestAdmissionPolicy

@NonNull McpRequestAdmissionPolicy getRequestAdmissionPolicy()

Provides the request admission policy.

Returns:

the request admission policy

getRequestInterceptor

@NonNull McpRequestInterceptor getRequestInterceptor()

Provides the request interceptor.

Returns:

the request interceptor

getResponseMarshaler

@NonNull McpResponseMarshaler getResponseMarshaler()

Provides the response marshaler used for tool structured content.

Returns:

the response marshaler

getCorsAuthorizer

@NonNull McpCorsAuthorizer getCorsAuthorizer()

Provides the MCP CORS authorizer.

Returns:

the CORS authorizer

getSessionStore

@NonNull McpSessionStore getSessionStore()

Provides the session store.

Returns:

the session store

getIdGenerator

@NonNull IdGenerator<String> getIdGenerator()

Provides the generator used for MCP session IDs.

Returns:

the session ID generator

close

default void close()
            throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception

withPort

static @NonNull McpServer.Builder withPort(@NonNull Integer port)

Acquires a builder configured with the given port.

Parameters:

port - the port to bind

Returns:

a new MCP server builder

fromPort

static @NonNull McpServer fromPort(@NonNull Integer port)

Creates a default MCP server bound to the given port.

Parameters:

port - the port to bind

Returns:

the built MCP server