Spring AI 是 Spring 官方的 AI 开发框架,支持通过 MCP 协议接入外部工具。
需使用 Spring AI 1.1.0-SNAPSHOT 及以上版本

依赖配置

pom.xml 中添加 Spring AI BOM:
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.ai</groupId>
      <artifactId>spring-ai-bom</artifactId>
      <version>1.1.0-SNAPSHOT</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

MCP 客户端配置

import org.springframework.ai.mcp.client.McpClient;

@Configuration
public class McpConfig {
    
    @Bean
    public McpClient investodayMcpClient() {
        return McpClient.builder()
            .url("https://data-api.investoday.net/data/mcp/preset?apiKey=YOUR_API_KEY")
            .build();
    }
}

使用示例

@Service
public class FinancialDataService {
    
    @Autowired
    private McpClient mcpClient;
    
    public StockInfo getStockRealtime(String symbol) {
        // 调用 MCP 工具获取实时行情
        var result = mcpClient.callTool("get_stock_realtime", 
            Map.of("symbol", symbol));
        return parseResult(result);
    }
}

完整示例项目

我们提供了完整的 Spring AI MCP 集成示例:

Spring AI MCP Demo

查看完整示例代码

常见问题

需要 Spring AI 1.1.0-SNAPSHOT 或更高版本,早期版本不支持 MCP 协议。
可以在 McpClient 配置中设置超时时间:
McpClient.builder()
    .url("...")
    .connectTimeout(Duration.ofSeconds(10))
    .readTimeout(Duration.ofSeconds(30))
    .build();

返回 MCP Server 总览

查看其他客户端配置