McpServer.SyncSpecification

java.lang.Object
- io.modelcontextprotocol.server.McpServer.SyncSpecification

封闭接口:: McpServer

public static class McpServer.SyncSpecification
extends java.lang.Object

Synchronous server specification.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`McpSyncServer`	`build()` Builds a synchronous MCP server that provides blocking operations.
`McpServer.SyncSpecification`	`capabilities(McpSchema.ServerCapabilities serverCapabilities)` Sets the server capabilities that will be advertised to clients during connection initialization.
`McpServer.SyncSpecification`	`objectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)` Sets the object mapper to use for serializing and deserializing JSON messages.
`McpServer.SyncSpecification`	`prompts(java.util.List<McpServerFeatures.SyncPromptSpecification> prompts)` Registers multiple prompts with their handlers using a List.
`McpServer.SyncSpecification`	`prompts(java.util.Map<java.lang.String,McpServerFeatures.SyncPromptSpecification> prompts)` Registers multiple prompts with their handlers using a Map.
`McpServer.SyncSpecification`	`prompts(McpServerFeatures.SyncPromptSpecification... prompts)` Registers multiple prompts with their handlers using varargs.
`McpServer.SyncSpecification`	`resources(java.util.List<McpServerFeatures.SyncResourceSpecification> resourceSpecifications)` Registers multiple resources with their handlers using a List.
`McpServer.SyncSpecification`	`resources(java.util.Map<java.lang.String,McpServerFeatures.SyncResourceSpecification> resourceSpecifications)` Registers multiple resources with their handlers using a Map.
`McpServer.SyncSpecification`	`resources(McpServerFeatures.SyncResourceSpecification... resourceSpecifications)` Registers multiple resources with their handlers using varargs.
`McpServer.SyncSpecification`	`resourceTemplates(java.util.List<McpServerFeatures.SyncResourceTemplateSpecification> resourceTemplates)` Sets the resource templates that define patterns for dynamic resource access.
`McpServer.SyncSpecification`	`resourceTemplates(McpServerFeatures.SyncResourceTemplateSpecification... resourceTemplates)` Sets the resource templates using varargs for convenience.
`McpServer.SyncSpecification`	`rootsChangeHandler(java.util.function.BiConsumer<McpSyncServerExchange,java.util.List<McpSchema.Root>> handler)` Registers a consumer that will be notified when the list of roots changes.
`McpServer.SyncSpecification`	`rootsChangeHandlers(java.util.function.BiConsumer<McpSyncServerExchange,java.util.List<McpSchema.Root>>... handlers)` Registers multiple consumers that will be notified when the list of roots changes using varargs.
`McpServer.SyncSpecification`	`rootsChangeHandlers(java.util.List<java.util.function.BiConsumer<McpSyncServerExchange,java.util.List<McpSchema.Root>>> handlers)` Registers multiple consumers that will be notified when the list of roots changes.
`McpServer.SyncSpecification`	`serverInfo(McpSchema.Implementation serverInfo)` Sets the server implementation information that will be shared with clients during connection initialization.
`McpServer.SyncSpecification`	`serverInfo(java.lang.String name, java.lang.String version)` Sets the server implementation information using name and version strings.
`McpServer.SyncSpecification`	`tool(McpSchema.Tool tool, java.util.function.BiFunction<McpSyncServerExchange,java.util.Map<java.lang.String,java.lang.Object>,McpSchema.CallToolResult> handler)` Adds a single tool with its implementation handler to the server.
`McpServer.SyncSpecification`	`tools(java.util.List<McpServerFeatures.SyncToolSpecification> toolSpecifications)` Adds multiple tools with their handlers to the server using a List.
`McpServer.SyncSpecification`	`tools(McpServerFeatures.SyncToolSpecification... toolSpecifications)` Adds multiple tools with their handlers to the server using varargs.

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

- 方法详细资料
  - serverInfo
```
public McpServer.SyncSpecification serverInfo(McpSchema.Implementation serverInfo)
```
    Sets the server implementation information that will be shared with clients during connection initialization. This helps with version compatibility, debugging, and server identification.
    
    参数:
    
    serverInfo - The server implementation details including name and version. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if serverInfo is null
  - serverInfo
```
public McpServer.SyncSpecification serverInfo(java.lang.String name,
                                              java.lang.String version)
```
    Sets the server implementation information using name and version strings. This is a convenience method alternative to serverInfo(McpSchema.Implementation).
    
    参数:
    
    name - The server name. Must not be null or empty.
    
    version - The server version. Must not be null or empty.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if name or version is null or empty
    
    另请参阅:
    
    serverInfo(McpSchema.Implementation)
  - capabilities
```
public McpServer.SyncSpecification capabilities(McpSchema.ServerCapabilities serverCapabilities)
```
    Sets the server capabilities that will be advertised to clients during connection initialization. Capabilities define what features the server supports, such as:
    - Tool execution
    - Resource access
    - Prompt handling
    参数:
    
    serverCapabilities - The server capabilities configuration. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if serverCapabilities is null
  - tool
```
public McpServer.SyncSpecification tool(McpSchema.Tool tool,
                                        java.util.function.BiFunction<McpSyncServerExchange,java.util.Map<java.lang.String,java.lang.Object>,McpSchema.CallToolResult> handler)
```
    Adds a single tool with its implementation handler to the server. This is a convenience method for registering individual tools without creating a McpServerFeatures.SyncToolSpecification explicitly.
    Example usage:
```
 .tool(
     new Tool("calculator", "Performs calculations", schema),
     (exchange, args) -> new CallToolResult("Result: " + calculate(args))
 )
 
```
    参数:
    
    tool - The tool definition including name, description, and schema. Must not be null.
    
    handler - The function that implements the tool's logic. Must not be null. The function's first argument is an McpSyncServerExchange upon which the server can interact with the connected client. The second argument is the list of arguments passed to the tool.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if tool or handler is null
  - tools
```
public McpServer.SyncSpecification tools(java.util.List<McpServerFeatures.SyncToolSpecification> toolSpecifications)
```
    Adds multiple tools with their handlers to the server using a List. This method is useful when tools are dynamically generated or loaded from a configuration source.
    
    参数:
    
    toolSpecifications - The list of tool specifications to add. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if toolSpecifications is null
    
    另请参阅:
    
    tools(McpServerFeatures.SyncToolSpecification...)
  - tools
```
public McpServer.SyncSpecification tools(McpServerFeatures.SyncToolSpecification... toolSpecifications)
```
    Adds multiple tools with their handlers to the server using varargs. This method provides a convenient way to register multiple tools inline.
    Example usage:
```
 .tools(
     new ToolSpecification(calculatorTool, calculatorHandler),
     new ToolSpecification(weatherTool, weatherHandler),
     new ToolSpecification(fileManagerTool, fileManagerHandler)
 )
 
```
    参数:
    
    toolSpecifications - The tool specifications to add. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if toolSpecifications is null
    
    另请参阅:
    
    tools(List)
  - resources
```
public McpServer.SyncSpecification resources(java.util.Map<java.lang.String,McpServerFeatures.SyncResourceSpecification> resourceSpecifications)
```
    Registers multiple resources with their handlers using a Map. This method is useful when resources are dynamically generated or loaded from a configuration source.
    
    参数:
    
    resourceSpecifications - Map of resource name to specification. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if resourceSpecifications is null
    
    另请参阅:
    
    resources(McpServerFeatures.SyncResourceSpecification...)
  - resources
```
public McpServer.SyncSpecification resources(java.util.List<McpServerFeatures.SyncResourceSpecification> resourceSpecifications)
```
    Registers multiple resources with their handlers using a List. This method is useful when resources need to be added in bulk from a collection.
    
    参数:
    
    resourceSpecifications - List of resource specifications. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if resourceSpecifications is null
    
    另请参阅:
    
    resources(McpServerFeatures.SyncResourceSpecification...)
  - resources
```
public McpServer.SyncSpecification resources(McpServerFeatures.SyncResourceSpecification... resourceSpecifications)
```
    Registers multiple resources with their handlers using varargs. This method provides a convenient way to register multiple resources inline.
    Example usage:
```
 .resources(
     new ResourceSpecification(fileResource, fileHandler),
     new ResourceSpecification(dbResource, dbHandler),
     new ResourceSpecification(apiResource, apiHandler)
 )
 
```
    参数:
    
    resourceSpecifications - The resource specifications to add. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if resourceSpecifications is null
  - resourceTemplates
```
public McpServer.SyncSpecification resourceTemplates(java.util.List<McpServerFeatures.SyncResourceTemplateSpecification> resourceTemplates)
```
    Sets the resource templates that define patterns for dynamic resource access. Templates use URI patterns with placeholders that can be filled at runtime.
    Example usage:
```
 .resourceTemplates(
     new ResourceTemplate("file://{path}", "Access files by path"),
     new ResourceTemplate("db://{table}/{id}", "Access database records")
 )
 
```
    参数:
    
    resourceTemplates - List of resource templates. If null, clears existing templates.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if resourceTemplates is null.
    
    另请参阅:
    
    #resourceTemplates(List...)
  - resourceTemplates
```
public McpServer.SyncSpecification resourceTemplates(McpServerFeatures.SyncResourceTemplateSpecification... resourceTemplates)
```
    Sets the resource templates using varargs for convenience. This is an alternative to resourceTemplates(List).
    
    参数:
    
    resourceTemplates - The resource templates to set.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if resourceTemplates is null
    
    另请参阅:
    
    resourceTemplates(List)
  - prompts
```
public McpServer.SyncSpecification prompts(java.util.Map<java.lang.String,McpServerFeatures.SyncPromptSpecification> prompts)
```
    Registers multiple prompts with their handlers using a Map. This method is useful when prompts are dynamically generated or loaded from a configuration source.
    Example usage:
```
 Map<String, PromptSpecification> prompts = new HashMap<>();
 prompts.put("analysis", new PromptSpecification(
     new Prompt("analysis", "Code analysis template"),
     (exchange, request) -> new GetPromptResult(generateAnalysisPrompt(request))
 ));
 .prompts(prompts)
 
```
    参数:
    
    prompts - Map of prompt name to specification. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if prompts is null
  - prompts
```
public McpServer.SyncSpecification prompts(java.util.List<McpServerFeatures.SyncPromptSpecification> prompts)
```
    Registers multiple prompts with their handlers using a List. This method is useful when prompts need to be added in bulk from a collection.
    
    参数:
    
    prompts - List of prompt specifications. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if prompts is null
    
    另请参阅:
    
    prompts(McpServerFeatures.SyncPromptSpecification...)
  - prompts
```
public McpServer.SyncSpecification prompts(McpServerFeatures.SyncPromptSpecification... prompts)
```
    Registers multiple prompts with their handlers using varargs. This method provides a convenient way to register multiple prompts inline.
    Example usage:
```
 .prompts(
     new PromptSpecification(analysisPrompt, analysisHandler),
     new PromptSpecification(summaryPrompt, summaryHandler),
     new PromptSpecification(reviewPrompt, reviewHandler)
 )
 
```
    参数:
    
    prompts - The prompt specifications to add. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if prompts is null
  - rootsChangeHandler
```
public McpServer.SyncSpecification rootsChangeHandler(java.util.function.BiConsumer<McpSyncServerExchange,java.util.List<McpSchema.Root>> handler)
```
    Registers a consumer that will be notified when the list of roots changes. This is useful for updating resource availability dynamically, such as when new files are added or removed.
    
    参数:
    
    handler - The handler to register. Must not be null. The function's first argument is an McpSyncServerExchange upon which the server can interact with the connected client. The second argument is the list of roots.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if consumer is null
  - rootsChangeHandlers
```
public McpServer.SyncSpecification rootsChangeHandlers(java.util.List<java.util.function.BiConsumer<McpSyncServerExchange,java.util.List<McpSchema.Root>>> handlers)
```
    Registers multiple consumers that will be notified when the list of roots changes. This method is useful when multiple consumers need to be registered at once.
    
    参数:
    
    handlers - The list of handlers to register. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if consumers is null
    
    另请参阅:
    
    rootsChangeHandler(BiConsumer)
  - rootsChangeHandlers
```
public McpServer.SyncSpecification rootsChangeHandlers(java.util.function.BiConsumer<McpSyncServerExchange,java.util.List<McpSchema.Root>>... handlers)
```
    Registers multiple consumers that will be notified when the list of roots changes using varargs. This method provides a convenient way to register multiple consumers inline.
    
    参数:
    
    handlers - The handlers to register. Must not be null.
    
    返回:
    
    This builder instance for method chaining
    
    抛出:
    
    java.lang.IllegalArgumentException - if consumers is null
    
    另请参阅:
    
    rootsChangeHandlers(List)
  - objectMapper
```
public McpServer.SyncSpecification objectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
```
    Sets the object mapper to use for serializing and deserializing JSON messages.
    
    参数:
    
    objectMapper - the instance to use. Must not be null.
    
    返回:
    
    This builder instance for method chaining.
    
    抛出:
    
    java.lang.IllegalArgumentException - if objectMapper is null
  - build
```
public McpSyncServer build()
```
    Builds a synchronous MCP server that provides blocking operations.
    
    返回:
    
    A new instance of McpSyncServer configured with this builder's settings.

类 McpServer.SyncSpecification

方法概要

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

方法详细资料

serverInfo

serverInfo

capabilities

tool

tools

tools

resources

resources

resources

resourceTemplates

resourceTemplates

prompts

prompts

prompts

rootsChangeHandler

rootsChangeHandlers

rootsChangeHandlers

objectMapper

build