Package org.springframework.ai.autoconfigure.mcp.client.stdio

Class MpcStdioClientAutoConfiguration

java.lang.Object

org.springframework.ai.autoconfigure.mcp.client.stdio.MpcStdioClientAutoConfiguration

@AutoConfiguration
@ConditionalOnClass({io.modelcontextprotocol.spec.McpSchema.class,io.modelcontextprotocol.client.McpSyncClient.class})
@EnableConfigurationProperties(McpStdioClientProperties.class)
@ConditionalOnProperty(prefix="spring.ai.mcp.client.stdio",
                       name="enabled",
                       havingValue="true")
public class MpcStdioClientAutoConfiguration
extends Object

Auto-configuration for Model Context Protocol (MCP) STDIO clients.

This configuration is responsible for setting up MCP clients that communicate with MCP servers through standard input/output (STDIO). It creates and configures McpSyncClient instances based on the provided configuration properties.

The configuration is conditionally enabled when:

• Required classes (McpSchema and McpSyncClient) are present on the classpath
• The 'spring.ai.mcp.client.stdio.enabled' property is set to 'true'

This auto-configuration provides:

• A List<McpSyncClient> bean configured for STDIO communication
• A McpSyncClientConfigurer bean for customizing the MCP sync client configuration
• A List<ToolCallback> bean containing tool callbacks from the MCP clients

Since:

1.0.0

Author:

Christian Tzolov

See Also:

• McpStdioClientProperties
• McpSyncClient
• McpToolCallback

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	MpcStdioClientAutoConfiguration.ClosebleMcpSyncClients

Constructor Summary

Constructors

Constructor	Description
MpcStdioClientAutoConfiguration()

Method Summary

Modifier and Type	Method	Description
MpcStdioClientAutoConfiguration.ClosebleMcpSyncClients	makeThemClosable(List<io.modelcontextprotocol.client.McpSyncClient> clients)
List<io.modelcontextprotocol.client.McpSyncClient>	mcpSyncClients(McpSyncClientConfigurer mcpSyncClientConfigurer, McpStdioClientProperties clientProperties)
List<ToolCallback>	toolCallbacks(List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)

Methods inherited from class java.lang.Object

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

Constructor Details

MpcStdioClientAutoConfiguration

public MpcStdioClientAutoConfiguration()

Method Details

mcpSyncClients

@Bean
public List<io.modelcontextprotocol.client.McpSyncClient> mcpSyncClients(McpSyncClientConfigurer mcpSyncClientConfigurer,
 McpStdioClientProperties clientProperties)

toolCallbacks

@Bean
public List<ToolCallback> toolCallbacks(List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)

makeThemClosable

@Bean
public MpcStdioClientAutoConfiguration.ClosebleMcpSyncClients makeThemClosable(List<io.modelcontextprotocol.client.McpSyncClient> clients)