io.modelcontextprotocol.server

类 McpSyncServerExchange

java.lang.Object

io.modelcontextprotocol.server.McpSyncServerExchange

public class McpSyncServerExchange
extends java.lang.Object

Represents a synchronous exchange with a Model Context Protocol (MCP) client. The exchange provides methods to interact with the client and query its capabilities.

构造器概要

构造器

构造器和说明
McpSyncServerExchange(McpAsyncServerExchange exchange) Create a new synchronous exchange with the client using the provided asynchronous implementation as a delegate.

方法概要

限定符和类型	方法和说明
McpSchema.ElicitResult	createElicitation(McpSchema.ElicitRequest elicitRequest) Creates a new elicitation.
McpSchema.CreateMessageResult	createMessage(McpSchema.CreateMessageRequest createMessageRequest) Create a new message using the sampling capabilities of the client.
McpSchema.ClientCapabilities	getClientCapabilities() Get the client capabilities that define the supported features and functionality.
McpSchema.Implementation	getClientInfo() Get the client implementation information.
McpSchema.ListRootsResult	listRoots() Retrieves the list of all roots provided by the client.
McpSchema.ListRootsResult	listRoots(java.lang.String cursor) Retrieves a paginated list of roots provided by the client.
void	loggingNotification(McpSchema.LoggingMessageNotification loggingMessageNotification) Send a logging message notification to the client.
java.lang.Object	ping() Sends a synchronous ping request to the client.
void	progressNotification(McpSchema.ProgressNotification progressNotification) Sends a notification to the client that the current progress status has changed for long-running operations.
java.lang.String	sessionId() Provides the Session ID
McpTransportContext	transportContext() Provides the McpTransportContext associated with the transport layer.

从类继承的方法 java.lang.Object

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

构造器详细资料

McpSyncServerExchange

public McpSyncServerExchange(McpAsyncServerExchange exchange)

Create a new synchronous exchange with the client using the provided asynchronous implementation as a delegate.

参数:

exchange - The asynchronous exchange to delegate to.

方法详细资料

sessionId

public java.lang.String sessionId()

Provides the Session ID

返回:

session ID

getClientCapabilities

public McpSchema.ClientCapabilities getClientCapabilities()

Get the client capabilities that define the supported features and functionality.

返回:

The client capabilities

getClientInfo

public McpSchema.Implementation getClientInfo()

Get the client implementation information.

返回:

The client implementation details

transportContext

public McpTransportContext transportContext()

Provides the McpTransportContext associated with the transport layer. For HTTP transports it can contain the metadata associated with the HTTP request that triggered the processing.

返回:

the transport context object

createMessage

public McpSchema.CreateMessageResult createMessage(McpSchema.CreateMessageRequest createMessageRequest)

Create a new message using the sampling capabilities of the client. The Model Context Protocol (MCP) provides a standardized way for servers to request LLM sampling (“completions” or “generations”) from language models via clients. This flow allows clients to maintain control over model access, selection, and permissions while enabling servers to leverage AI capabilities—with no server API keys necessary. Servers can request text or image-based interactions and optionally include context from MCP servers in their prompts.

参数:

createMessageRequest - The request to create a new message

返回:

A result containing the details of the sampling response

另请参阅:

McpSchema.CreateMessageRequest, McpSchema.CreateMessageResult, Sampling Specification

createElicitation

public McpSchema.ElicitResult createElicitation(McpSchema.ElicitRequest elicitRequest)

Creates a new elicitation. MCP provides a standardized way for servers to request additional information from users through the client during interactions. This flow allows clients to maintain control over user interactions and data sharing while enabling servers to gather necessary information dynamically. Servers can request structured data from users with optional JSON schemas to validate responses.

参数:

elicitRequest - The request to create a new elicitation

返回:

A result containing the elicitation response.

另请参阅:

McpSchema.ElicitRequest, McpSchema.ElicitResult, Elicitation Specification

listRoots

public McpSchema.ListRootsResult listRoots()

Retrieves the list of all roots provided by the client.

返回:

The list of roots result.

listRoots

public McpSchema.ListRootsResult listRoots(java.lang.String cursor)

Retrieves a paginated list of roots provided by the client.

参数:

cursor - Optional pagination cursor from a previous list request

返回:

The list of roots result

loggingNotification

public void loggingNotification(McpSchema.LoggingMessageNotification loggingMessageNotification)

Send a logging message notification to the client. Messages below the current minimum logging level will be filtered out.

参数:

loggingMessageNotification - The logging message to send

progressNotification

public void progressNotification(McpSchema.ProgressNotification progressNotification)

Sends a notification to the client that the current progress status has changed for long-running operations.

参数:

progressNotification - The progress notification to send

ping

public java.lang.Object ping()

Sends a synchronous ping request to the client.

返回: