Spring AI MCP Server 集成与源码解析

Spring AI MCP Server通过Java SDK和Spring Boot扩展提供MCP协议支持，示例展示了工具注册、客户端调用流程及关键源码分析。核心组件包括McpSchema协议定义、同步/异步客户端封装及自动配置类，实现AI模型与外部服务的标准化交互。

涅槃凤凰发布于 2026/2/6更新于 2026/4/181 浏览

概述

本文介绍Spring AI MCP Server的集成方式、工具注册及客户端调用示例，并分析相关源码实现。

MCP Java SDK依赖配置

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.modelcontextprotocol.sdk</groupId>
      <artifactId>mcp-bom</artifactId>
      <version>0.8.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
<dependency>
  <groupId>io.modelcontextprotocol.sdk</groupId>
  <artifactId>mcp</artifactId>
</dependency>
<dependency>
  <groupId>io.modelcontextprotocol.sdk</groupId>
  <artifactId>mcp-spring-webflux</>


  io.modelcontextprotocol.sdk
  mcp-spring-webmvc

相关免费在线工具

Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online
Escape 与 Native 编解码
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online
JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online
JavaScript 压缩与混淆
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online
RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。在线工具，RSA密钥对生成器在线工具，online
Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。在线工具，Mermaid 预览与可视化编辑在线工具，online

<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
</dependency>

@Bean
public ToolCallbackProvider weatherTools(WeatherService weatherService) {
  return MethodToolCallbackProvider.builder()
    .toolObjects(weatherService)
    .build();
}

@Bean
public ToolCallback toUpperCase() {
  return FunctionToolCallback.builder("toUpperCase", input -> input.input().toUpperCase())
    .inputType(TextInput.class)
    .description("Convert text to uppercase")
    .build();
}

@Service
public class WeatherService {
  private static final String BASE_URL = "https://api.weather.gov";
  private final RestClient restClient;

  public WeatherService() {
    this.restClient = RestClient.builder()
      .baseUrl(BASE_URL)
      .defaultHeader("Accept", "application/geo+json")
      .defaultHeader("User-Agent", "WeatherApiClient/1.0")
      .build();
  }

  @Tool(description = "Get weather forecast by location")
  public String getWeatherForecastByLocation(double latitude, double longitude) {
    var points = restClient.get()
      .uri("/points/{lat},{lon}", latitude, longitude)
      .retrieve()
      .body(Points.class);
    // 处理预报数据...
  }

  @Tool(description = "Get weather alerts for state")
  public String getAlerts(String state) {
    Alert alert = restClient.get()
      .uri("/alerts/active/area/{state}", state)
      .retrieve()
      .body(Alert.class);
    // 处理警报数据...
  }
}

var transport = new HttpClientSseClientTransport("http://localhost:8080");
var client = McpClient.sync(transport).build();
client.initialize();

// 获取可用工具列表
ListToolsResult tools = client.listTools();

// 调用天气查询工具
CallToolResult result = client.callTool(
  new CallToolRequest("getWeatherForecastByLocation",
    Map.of("latitude", "47.6062", "longitude", "-122.3321"))
);

Spring AI MCP Server 集成与源码解析

概述

MCP Java SDK依赖配置

更多推荐文章

相关免费在线工具

Spring AI MCP扩展依赖

工具注册示例

配置类

WeatherService实现

客户端调用示例

核心源码解析

McpSchema协议定义

McpSyncClient同步封装

自动配置类

总结

Spring AI MCP Server 集成与源码解析

概述

MCP Java SDK依赖配置

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

Spring AI MCP扩展依赖

工具注册示例

配置类

WeatherService实现

客户端调用示例

核心源码解析

McpSchema协议定义

McpSyncClient同步封装

自动配置类

总结