Class McpImageContent

java.lang.Object

com.soklet.McpImageContent

All Implemented Interfaces:

McpContentBlock

@ThreadSafe
public final class McpImageContent
extends Object
implements McpContentBlock

Immutable binary image MCP content block.

The MIME type is validated as an ASCII type/subtype with optional parameters, using the same syntax parser as MCP Apps. Malformed syntax, controls, non-ASCII characters, and duplicate parameter names are rejected. Its spelling is retained; Soklet does not inspect the bytes or check whether a particular client supports the declared format.

The built-in server can send at most 786,432 raw bytes per binary content item: Base64 encoding must fit the 1,048,576-character JSON string limit. The complete response must also fit the 4 MiB UTF-8 JSON limit. Construction defensively copies data but does not prevalidate the eventual response size. Prefer McpResourceLink for larger payloads.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpImageContent.Builder	Mutable builder for immutable McpImageContent.

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
@NonNull Optional<@NonNull McpContentAnnotations>	getAnnotations()	Returns optional presentation annotations for this content block.
byte @NonNull []	getData()
@NonNull McpJsonObject	getMetadata()	Returns protocol extension metadata associated with this content block.
@NonNull String	getMimeType()
int	hashCode()
static @NonNull McpImageContent.Builder	withDataAndMimeType(byte @NonNull [] data, @NonNull String mimeType)	Vends a builder primed with image bytes and their MIME type.

Methods inherited from class Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Details

withDataAndMimeType

public static @NonNull McpImageContent.Builder withDataAndMimeType(byte @NonNull [] data,
 @NonNull String mimeType)

Vends a builder primed with image bytes and their MIME type.

Parameters:

data - image bytes, defensively copied

mimeType - image MIME type

Returns:

image-content builder

Throws:

IllegalArgumentException - if the MIME type has malformed syntax

getData

public byte @NonNull [] getData()

Returns:

a defensive copy of the image bytes

getMimeType

public @NonNull String getMimeType()

Returns:

image MIME type

getAnnotations

public @NonNull Optional<@NonNull McpContentAnnotations> getAnnotations()

Description copied from interface: McpContentBlock

Returns optional presentation annotations for this content block.

Specified by:

getAnnotations in interface McpContentBlock

Returns:

content annotations, if supplied

getMetadata

public @NonNull McpJsonObject getMetadata()

Description copied from interface: McpContentBlock

Returns protocol extension metadata associated with this content block.

Specified by:

getMetadata in interface McpContentBlock

Returns:

immutable extension metadata

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether every content property is structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural content hash code