McpSyncClient

java.lang.Object
- io.modelcontextprotocol.client.McpSyncClient

所有已实现的接口:

java.lang.AutoCloseable
```
public class McpSyncClient
extends java.lang.Object
implements java.lang.AutoCloseable
```
A synchronous client implementation for the Model Context Protocol (MCP) that wraps an McpAsyncClient to provide blocking operations.
This client implements the MCP specification by delegating to an asynchronous client and blocking on the results. Key features include:
- Synchronous, blocking API for simpler integration in non-reactive applications
- Tool discovery and invocation for server-provided functionality
- Resource access and management with URI-based addressing
- Prompt template handling for standardized AI interactions
- Real-time notifications for tools, resources, and prompts changes
- Structured logging with configurable severity levels
The client follows the same lifecycle as its async counterpart:
1. Initialization - Establishes connection and negotiates capabilities
2. Normal Operation - Handles requests and notifications
3. Graceful Shutdown - Ensures clean connection termination
This implementation implements AutoCloseable for resource cleanup and provides both immediate and graceful shutdown options. All operations block until completion or timeout, making it suitable for traditional synchronous programming models.
另请参阅:

McpClient, McpAsyncClient, McpSchema

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`addRoot(McpSchema.Root root)` Add a roots dynamically.
`McpSchema.CallToolResult`	`callTool(McpSchema.CallToolRequest callToolRequest)` Calls a tool provided by the server.
`void`	`close()`
`boolean`	`closeGracefully()`
`McpSchema.CompleteResult`	`completeCompletion(McpSchema.CompleteRequest completeRequest)` Send a completion/complete request.
`McpSchema.ClientCapabilities`	`getClientCapabilities()` Get the client capabilities that define the supported features and functionality.
`McpSchema.Implementation`	`getClientInfo()` Get the client implementation information.
`McpSchema.InitializeResult`	`getCurrentInitializationResult()` Get the current initialization result.
`McpSchema.GetPromptResult`	`getPrompt(McpSchema.GetPromptRequest getPromptRequest)`
`McpSchema.ServerCapabilities`	`getServerCapabilities()` Get the server capabilities that define the supported features and functionality.
`McpSchema.Implementation`	`getServerInfo()` Get the server implementation information.
`java.lang.String`	`getServerInstructions()` Get the server instructions that provide guidance to the client on how to interact with this server.
`McpSchema.InitializeResult`	`initialize()` The initialization phase MUST be the first interaction between client and server.
`boolean`	`isInitialized()` Check if the client-server connection is initialized.
`McpSchema.ListPromptsResult`	`listPrompts()` Retrieves the list of all prompts provided by the server.
`McpSchema.ListPromptsResult`	`listPrompts(java.lang.String cursor)` Retrieves a paginated list of prompts provided by the server.
`McpSchema.ListResourcesResult`	`listResources()` Retrieves the list of all resources provided by the server.
`McpSchema.ListResourcesResult`	`listResources(java.lang.String cursor)` Retrieves a paginated list of resources provided by the server.
`McpSchema.ListResourceTemplatesResult`	`listResourceTemplates()` Retrieves the list of all resource templates provided by the server.
`McpSchema.ListResourceTemplatesResult`	`listResourceTemplates(java.lang.String cursor)` Resource templates allow servers to expose parameterized resources using URI templates.
`McpSchema.ListToolsResult`	`listTools()` Retrieves the list of all tools provided by the server.
`McpSchema.ListToolsResult`	`listTools(java.lang.String cursor)` Retrieves a paginated list of tools provided by the server.
`java.lang.Object`	`ping()` Send a synchronous ping request.
`McpSchema.ReadResourceResult`	`readResource(McpSchema.ReadResourceRequest readResourceRequest)` Send a resources/read request.
`McpSchema.ReadResourceResult`	`readResource(McpSchema.Resource resource)` Send a resources/read request.
`void`	`removeRoot(java.lang.String rootUri)` Remove a root dynamically.
`void`	`rootsListChangedNotification()` Send a roots/list_changed notification.
`void`	`setLoggingLevel(McpSchema.LoggingLevel loggingLevel)` Client can set the minimum logging level it wants to receive from the server.
`void`	`subscribeResource(McpSchema.SubscribeRequest subscribeRequest)` Subscriptions.
`void`	`unsubscribeResource(McpSchema.UnsubscribeRequest unsubscribeRequest)` Send a resources/unsubscribe request.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getCurrentInitializationResult
```
public McpSchema.InitializeResult getCurrentInitializationResult()
```
    Get the current initialization result.
    
    返回:
    
    the initialization result.
  - getServerCapabilities
```
public McpSchema.ServerCapabilities getServerCapabilities()
```
    Get the server capabilities that define the supported features and functionality.
    
    返回:
    
    The server capabilities
  - getServerInstructions
```
public java.lang.String getServerInstructions()
```
    Get the server instructions that provide guidance to the client on how to interact with this server.
    
    返回:
    
    The instructions
  - getServerInfo
```
public McpSchema.Implementation getServerInfo()
```
    Get the server implementation information.
    
    返回:
    
    The server implementation details
  - isInitialized
```
public boolean isInitialized()
```
    Check if the client-server connection is initialized.
    
    返回:
    
    true if the client-server connection is initialized
  - 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
  - close
```
public void close()
```
    指定者:
    
    close 在接口中 java.lang.AutoCloseable
  - closeGracefully
```
public boolean closeGracefully()
```
  - initialize
```
public McpSchema.InitializeResult initialize()
```
    The initialization phase MUST be the first interaction between client and server. During this phase, the client and server:
    - Establish protocol version compatibility
    - Exchange and negotiate capabilities
    - Share implementation details
    The client MUST initiate this phase by sending an initialize request containing:
    - The protocol version the client supports
    - The client's capabilities
    - Client implementation information
    The server MUST respond with its own capabilities and information: McpSchema.ServerCapabilities.
    After successful initialization, the client MUST send an initialized notification to indicate it is ready to begin normal operations.
    Initialization Spec
    返回:
    
    the initialize result.
  - rootsListChangedNotification
```
public void rootsListChangedNotification()
```
    Send a roots/list_changed notification.
  - addRoot
```
public void addRoot(McpSchema.Root root)
```
    Add a roots dynamically.
  - removeRoot
```
public void removeRoot(java.lang.String rootUri)
```
    Remove a root dynamically.
  - ping
```
public java.lang.Object ping()
```
    Send a synchronous ping request.
    
    返回:
  - callTool
```
public McpSchema.CallToolResult callTool(McpSchema.CallToolRequest callToolRequest)
```
    Calls a tool provided by the server. Tools enable servers to expose executable functionality that can interact with external systems, perform computations, and take actions in the real world.
    
    参数:
    
    callToolRequest - The request containing: - name: The name of the tool to call (must match a tool name from tools/list) - arguments: Arguments that conform to the tool's input schema
    
    返回:
    
    The tool execution result containing: - content: List of content items (text, images, or embedded resources) representing the tool's output - isError: Boolean indicating if the execution failed (true) or succeeded (false/absent)
  - listTools
```
public McpSchema.ListToolsResult listTools()
```
    Retrieves the list of all tools provided by the server.
    
    返回:
    
    The list of all tools result containing: - tools: List of available tools, each with a name, description, and input schema - nextCursor: Optional cursor for pagination if more tools are available
  - listTools
```
public McpSchema.ListToolsResult listTools(java.lang.String cursor)
```
    Retrieves a paginated list of tools provided by the server.
    
    参数:
    
    cursor - Optional pagination cursor from a previous list request
    
    返回:
    
    The list of tools result containing: - tools: List of available tools, each with a name, description, and input schema - nextCursor: Optional cursor for pagination if more tools are available
  - listResources
```
public McpSchema.ListResourcesResult listResources()
```
    Retrieves the list of all resources provided by the server.
    
    返回:
    
    The list of all resources result
  - listResources
```
public McpSchema.ListResourcesResult listResources(java.lang.String cursor)
```
    Retrieves a paginated list of resources provided by the server.
    
    参数:
    
    cursor - Optional pagination cursor from a previous list request
    
    返回:
    
    The list of resources result
  - readResource
```
public McpSchema.ReadResourceResult readResource(McpSchema.Resource resource)
```
    Send a resources/read request.
    
    参数:
    
    resource - the resource to read
    
    返回:
    
    the resource content.
  - readResource
```
public McpSchema.ReadResourceResult readResource(McpSchema.ReadResourceRequest readResourceRequest)
```
    Send a resources/read request.
    
    参数:
    
    readResourceRequest - the read resource request.
    
    返回:
    
    the resource content.
  - listResourceTemplates
```
public McpSchema.ListResourceTemplatesResult listResourceTemplates()
```
    Retrieves the list of all resource templates provided by the server.
    
    返回:
    
    The list of all resource templates result.
  - listResourceTemplates
```
public McpSchema.ListResourceTemplatesResult listResourceTemplates(java.lang.String cursor)
```
    Resource templates allow servers to expose parameterized resources using URI templates. Arguments may be auto-completed through the completion API. Retrieves a paginated list of resource templates provided by the server.
    
    参数:
    
    cursor - Optional pagination cursor from a previous list request
    
    返回:
    
    The list of resource templates result.
  - subscribeResource
```
public void subscribeResource(McpSchema.SubscribeRequest subscribeRequest)
```
    Subscriptions. The protocol supports optional subscriptions to resource changes. Clients can subscribe to specific resources and receive notifications when they change. Send a resources/subscribe request.
    
    参数:
    
    subscribeRequest - the subscribe request contains the uri of the resource to subscribe to.
  - unsubscribeResource
```
public void unsubscribeResource(McpSchema.UnsubscribeRequest unsubscribeRequest)
```
    Send a resources/unsubscribe request.
    
    参数:
    
    unsubscribeRequest - the unsubscribe request contains the uri of the resource to unsubscribe from.
  - listPrompts
```
public McpSchema.ListPromptsResult listPrompts()
```
    Retrieves the list of all prompts provided by the server.
    
    返回:
    
    The list of all prompts result.
  - listPrompts
```
public McpSchema.ListPromptsResult listPrompts(java.lang.String cursor)
```
    Retrieves a paginated list of prompts provided by the server.
    
    参数:
    
    cursor - Optional pagination cursor from a previous list request
    
    返回:
    
    The list of prompts result.
  - getPrompt
```
public McpSchema.GetPromptResult getPrompt(McpSchema.GetPromptRequest getPromptRequest)
```
  - setLoggingLevel
```
public void setLoggingLevel(McpSchema.LoggingLevel loggingLevel)
```
    Client can set the minimum logging level it wants to receive from the server.
    
    参数:
    
    loggingLevel - the min logging level
  - completeCompletion
```
public McpSchema.CompleteResult completeCompletion(McpSchema.CompleteRequest completeRequest)
```
    Send a completion/complete request.
    
    参数:
    
    completeRequest - the completion request contains the prompt or resource reference and arguments for generating suggestions.
    
    返回:
    
    the completion result containing suggested values.

类 McpSyncClient

方法概要

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

方法详细资料

getCurrentInitializationResult

getServerCapabilities

getServerInstructions

getServerInfo

isInitialized

getClientCapabilities

getClientInfo

close

closeGracefully

initialize

rootsListChangedNotification

addRoot

removeRoot

ping

callTool

listTools

listTools

listResources

listResources

readResource

readResource

listResourceTemplates

listResourceTemplates

subscribeResource

unsubscribeResource

listPrompts

listPrompts

getPrompt

setLoggingLevel

completeCompletion