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 总览
查看其他客户端配置