Class McpProtectionConfig

java.lang.Object

com.soklet.McpProtectionConfig

@ThreadSafe
public final class McpProtectionConfig
extends Object

Immutable server-wide limits and provider selection for framework-protected MCP request state.

No configuration is required until an operation declares framework-protected request state. Development-ephemeral mode is explicit and is not portable across restarts or server instances. A production keyring is an immutable initial value; building a server copies it into independent live state and exposes subsequent mutation only through McpProtectionKeyringManager.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpProtectionConfig.Builder	Single-threaded builder for immutable request-state protection settings.

Method Summary

Modifier and Type	Method	Description
@NonNull Optional<@NonNull McpProtectionKeyring>	getInitialKeyring()	Returns the immutable initial ring configuration, not a server's live ring.
@NonNull Integer	getMaximumDecodedRequestStateSizeInBytes()
@NonNull Integer	getMaximumEncodedRequestStateSizeInBytes()
@NonNull Duration	getMaximumRequestStateLifetime()
@NonNull Integer	getMaximumRequestStateRounds()
@NonNull McpProtectionMode	getProtectionMode()
@NonNull Optional<@NonNull McpRequestStateProtector>	getRequestStateProtector()
static @NonNull McpProtectionConfig.Builder	withDevelopmentEphemeralProtection()	Vends an explicit development-ephemeral configuration builder.
static @NonNull McpProtectionConfig.Builder	withKeyring(@NonNull McpProtectionKeyring keyring)	Vends a production configuration builder.
static @NonNull McpProtectionConfig.Builder	withRequestStateProtector(@NonNull McpRequestStateProtector requestStateProtector)	Vends a custom-protector configuration builder.

Methods inherited from class Object

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

Method Details

withKeyring

public static @NonNull McpProtectionConfig.Builder withKeyring(@NonNull McpProtectionKeyring keyring)

Vends a production configuration builder.

Parameters:

keyring - immutable initial production ring

Returns:

protection configuration builder

withRequestStateProtector

public static @NonNull McpProtectionConfig.Builder withRequestStateProtector(@NonNull McpRequestStateProtector requestStateProtector)

Vends a custom-protector configuration builder.

Parameters:

requestStateProtector - application-owned protector

Returns:

protection configuration builder

withDevelopmentEphemeralProtection

public static @NonNull McpProtectionConfig.Builder withDevelopmentEphemeralProtection()

Vends an explicit development-ephemeral configuration builder.

Returns:

protection configuration builder

getProtectionMode

public @NonNull McpProtectionMode getProtectionMode()

Returns:

configured protection mode

getInitialKeyring

public @NonNull Optional<@NonNull McpProtectionKeyring> getInitialKeyring()

Returns the immutable initial ring configuration, not a server's live ring.

Returns:

initial keyring, if production protection is configured

getRequestStateProtector

public @NonNull Optional<@NonNull McpRequestStateProtector> getRequestStateProtector()

Returns:

custom application protector, when configured

getMaximumEncodedRequestStateSizeInBytes

public @NonNull Integer getMaximumEncodedRequestStateSizeInBytes()

Returns:

positive maximum encoded request-state size in bytes

getMaximumDecodedRequestStateSizeInBytes

public @NonNull Integer getMaximumDecodedRequestStateSizeInBytes()

Returns:

positive maximum decoded request-state size in bytes

getMaximumRequestStateLifetime

public @NonNull Duration getMaximumRequestStateLifetime()

Returns:

positive finite maximum request-state lifetime

getMaximumRequestStateRounds

public @NonNull Integer getMaximumRequestStateRounds()

Returns:

positive maximum request-state round count