Package org.springframework.ai.mcp

@NonNullApi @NonNullFields package org.springframework.ai.mcp

Core support for Model Context Protocol (MCP) integration in Spring AI.

This package provides the foundational classes and utilities for integrating MCP with Spring AI's tool system. It includes:

• Tool callback implementations for both synchronous and asynchronous MCP operations
• Tool callback providers that discover and expose MCP tools
• Utility classes for converting between Spring AI and MCP tool representations
• Support for customizing MCP client behavior

The classes in this package enable seamless integration between Spring AI applications and MCP servers, allowing language models to discover and invoke tools through a standardized protocol.

Since:

1.0.0

Author:

Christian Tzolov

Related Packages

Package	Description
org.springframework.ai.mcp.aot
org.springframework.ai.mcp.customizer

Class	Description
AsyncMcpToolCallback	Adapts MCP tools to Spring AI's ToolCallback interface with asynchronous execution.
AsyncMcpToolCallback.Builder	Builder for constructing AsyncMcpToolCallback instances.
AsyncMcpToolCallbackProvider	Provides MCP tools asynchronously from multiple MCP servers as Spring AI tool callbacks.
AsyncMcpToolCallbackProvider.Builder	Builder for AsyncMcpToolCallbackProvider configuration.
DefaultMcpToolNamePrefixGenerator	Default implementation of McpToolNamePrefixGenerator that ensures unique tool names for all client/server connections.
McpConnectionInfo	MCP connection info record containing the client and server related metadata.
McpConnectionInfo.Builder	Builder class for constructing McpConnectionInfo instances.
McpToolFilter	A BiPredicate for SyncMcpToolCallbackProvider and the AsyncMcpToolCallbackProvider to filter the discovered tool for the given McpConnectionInfo.
McpToolNamePrefixGenerator	Strategy interface for generating prefixed tool name based on MCP client/server and Tool information.
McpToolUtils	Utility class that provides helper methods for working with Model Context Protocol (MCP) tools in a Spring AI environment.
SyncMcpToolCallback	Synchronous adapter bridging MCP tools to Spring AI's ToolCallback interface.
SyncMcpToolCallback.Builder	Builder for SyncMcpToolCallback instances.
SyncMcpToolCallbackProvider	Provides Spring AI tool callbacks by discovering tools from MCP servers.
SyncMcpToolCallbackProvider.Builder	Builder for SyncMcpToolCallbackProvider.
ToolContextToMcpMetaConverter	Strategy interface for converting a ToolContext to a map of metadata to be sent as part of an MCP tool call.