最新快照版本请使用Spring AI 1.1.0！spring-doc.cadn.net.cn

MCPUtilities

MCP 工具为将模型上下文协议与 Spring AI 应用集成提供了基础支持。 这些工具使 Spring AI 的工具系统与 MCP 服务器之间能够无缝通信，支持同步和异步作。 它们通常用于程序化MCP客户端和服务器的配置与交互。 如果配置更简洁，可以考虑使用启动Starters。spring-doc.cadn.net.cn

ToolCallback 工具

工具回调适配器

将MCP工具适配至Spring AI的工具界面，支持同步和异步执行。spring-doc.cadn.net.cn

McpSyncClient mcpClient = // obtain MCP client
Tool mcpTool = // obtain MCP tool definition
ToolCallback callback = new SyncMcpToolCallback(mcpClient, mcpTool);

// Use the tool through Spring AI's interfaces
ToolDefinition definition = callback.getToolDefinition();
String result = callback.call("{\"param\": \"value\"}");
McpAsyncClient mcpClient = // obtain MCP client
Tool mcpTool = // obtain MCP tool definition
ToolCallback callback = new AsyncMcpToolCallback(mcpClient, mcpTool);

// Use the tool through Spring AI's interfaces
ToolDefinition definition = callback.getToolDefinition();
String result = callback.call("{\"param\": \"value\"}");

工具回调提供商

发现并提供来自MCP客户端的MCP工具。spring-doc.cadn.net.cn

McpSyncClient mcpClient = // obtain MCP client
ToolCallbackProvider provider = new SyncMcpToolCallbackProvider(mcpClient);

// Get all available tools
ToolCallback[] tools = provider.getToolCallbacks();

针对多个客户：spring-doc.cadn.net.cn

List<McpSyncClient> clients = // obtain list of clients
List<ToolCallback> callbacks = SyncMcpToolCallbackProvider.syncToolCallbacks(clients);

对于客户端子集的动态选择spring-doc.cadn.net.cn

@Autowired
private List<McpSyncClient> mcpSyncClients;

public ToolCallbackProvider buildProvider(Set<String> allowedServerNames) {
    // Filter by server.name().
    List<McpSyncClient> selected = mcpSyncClients.stream()
        .filter(c -> allowedServerNames.contains(c.getServerInfo().name()))
        .toList();

    return new SyncMcpToolCallbackProvider(selected);
}
McpAsyncClient mcpClient = // obtain MCP client
ToolCallbackProvider provider = new AsyncMcpToolCallbackProvider(mcpClient);

// Get all available tools
ToolCallback[] tools = provider.getToolCallbacks();

针对多个客户：spring-doc.cadn.net.cn

List<McpAsyncClient> clients = // obtain list of clients
Flux<ToolCallback> callbacks = AsyncMcpToolCallbackProvider.asyncToolCallbacks(clients);

McpToolUtils

工具回调至工具规格

将 Spring AI 工具回调转换为 MCP 工具规范：spring-doc.cadn.net.cn

List<ToolCallback> toolCallbacks = // obtain tool callbacks
List<SyncToolSpecifications> syncToolSpecs = McpToolUtils.toSyncToolSpecifications(toolCallbacks);

然后你可以使用McpServer.SyncSpecification注册工具规格：spring-doc.cadn.net.cn

McpServer.SyncSpecification syncSpec = ...
syncSpec.tools(syncToolSpecs);
List<ToolCallback> toolCallbacks = // obtain tool callbacks
List<AsyncToolSpecification> asyncToolSpecifications = McpToolUtils.toAsyncToolSpecifications(toolCallbacks);

然后你可以使用McpServer.AsyncSpecification注册工具规格：spring-doc.cadn.net.cn

McpServer.AsyncSpecification asyncSpec = ...
asyncSpec.tools(asyncToolSpecifications);

MCP客户端到工具回调

从MCP客户端获取工具回调spring-doc.cadn.net.cn

List<McpSyncClient> syncClients = // obtain sync clients
List<ToolCallback> syncCallbacks = McpToolUtils.getToolCallbacksFromSyncClients(syncClients);
List<McpAsyncClient> asyncClients = // obtain async clients
List<ToolCallback> asyncCallbacks = McpToolUtils.getToolCallbacksFromAsyncClients(asyncClients);

原生图像支持

这McpHintsclass 为 MCP 模式类提供 GraalVM 原生图像提示。 该类在构建原生映像时会自动注册MCP模式类所需的所有反射提示。spring-doc.cadn.net.cn