环境：SpringBoot3.4.2

---

1. 简介

1.1 什么是MCP

Model Context Protocol（MCP）模型上下文协议是一种标准化协议，它让大模型能够更容易地和外部的数据、工具连接起来。你可以把MCP想象成一个通用的插头或者接口，就像USB-C一样，不管是什么设备，只要插上这个接口，就能和电脑、充电器等连接起来。

注意，它连接的不是物理设备，而是AI模型和外部的数据源、工具等。有了MCP，AI模型就能更方便地获取外部的信息，完成更多的任务。比如，通过MCP，AI模型可以操作电脑读写文件，或者模拟浏览器操作等。

1.2 为什么需要MCP

首先，MCP提供了一个标准化的接口，使得AI模型能够轻松地与各种外部工具和数据源进行交互，无需为每个工具或数据源单独开发集成代码。

其次，MCP还解决了数据孤岛问题，通过统一协议连接分散的数据源，使AI模型能够实时访问和利用最新的数据。

总的来说，MCP就像是一个桥梁，让AI模型与外部世界更好地连接起来，从而发挥出更大的价值和潜力。

1.3 Java与MCP架构

• 客户端/服务器层：McpClient负责处理客户端操作，而McpServer则管理服务器端协议操作。两者都利用McpSession来进行通信管理。

• 会话层（McpSession）：通过DefaultMcpSession实现来管理通信模式和状态。

• 传输层（McpTransport）：处理JSON-RPC消息的序列化和反序列化，并支持多种传输实现。

MCP Client

---

MCP客户端是模型上下文协议（MCP）架构中的关键组件，负责建立和管理与MCP服务器的连接。它实现了协议的客户端部分，如下图所示：

MCP Server

---

MCP服务器是模型上下文协议（MCP）架构中的基础组件，它为客户端提供工具、资源和功能。它实现了协议的服务器端部分，如下图所示：

Spring AI 提供了相对应的Spring Boot staters来非常方便的进行 MCP 的集成。接下来，我们将详细的完成一个完整的MCP应用案例。

2. 实战案例

2.1 服务端开发

我们将在 MCP 服务端提供2个外部功能：查询天气预报、获取IP地址详细信息。

引入依赖

<dependency>`  `<groupId>com.alibaba.cloud.ai</groupId>`  `<artifactId>spring-ai-alibaba-starter</artifactId>`  `<version>1.0.0-M6.1</version>``</dependency>``<dependency>`  `<groupId>org.springframework.ai</groupId>`  `<artifactId>spring-ai-mcp-server-spring-boot-starter</artifactId>``</dependency>``<dependency>`  `<groupId>org.springframework.ai</groupId>`  `<artifactId>spring-ai-mcp-server-webflux-spring-boot-starter</artifactId>``</dependency>

说明：

• 引入alibaba-starter我们将使用阿里的大模型

• 引入mcp-server-webflux，以支持基于 Spring WebFlux 的 SSE（服务器发送事件）服务器传输

配置文件

​​​​​​​

spring:`  `ai:`    `dashscope:`      `api-key: sk-xxxooo`      `base-url: https://dashscope.aliyuncs.com/compatible-mode/v1`      `chat:`        `options:`          `stream: true`          `model: qwen-turbo``---``spring:`  `ai:`    `mcp:`      `server:`        `enabled: true`        `name: ai_mcp_server`        `version: 1.0.0`        `type: ASYNC`        `sse-message-endpoint: /mcp/message

以上我们就完成了基本的配置。接下来，我们需要提供2个外部工具。

工具编写

获取天气预报

​​​​​​​

public class CommonTool {`    `@Tool(description = "获取当前天气预报")`  `WeatherResponse getCurrentWeather(WeatherRequest request) {`    `System.err.printf("准备查询【%s】天气预报%n", request.city()) ;`    `RestClient client = RestClient.create(URI.create("https://api.vvhan.com")) ;`    `Map<?, ?> result = client.get()`        `.uri("/api/weather?city={0}", request.city())`        `.retrieve()`        `.body(Map.class) ;`    `try {`      `return new WeatherResponse(new ObjectMapper().writeValueAsString(result)) ;`    `} catch (JsonProcessingException e) {`      `throw new RuntimeException(e) ;`    `}`  `}`    `@Tool(description = "获取IP地址详细信息")`  `String getIpAddressInfo(String ip) {`    `System.err.printf("准备查询【%s】详细信息%n", ip) ;`    `RestClient client = RestClient.create(URI.create("https://api.vvhan.com")) ;`    `Map<?, ?> result = client.get()`        `.uri("/api/ipInfo?ip={0}", ip)`        `.retrieve()`        `.body(Map.class) ;`    `try {`      `return new ObjectMapper().writeValueAsString(result) ;`    `} catch (JsonProcessingException e) {`      `throw new RuntimeException(e) ;`    `}`  `}``}

注册工具

​​​​​​​

@Configuration``public class ToolsConfig {`  `@Bean`  `ToolCallbackProvider tools() {`    `ToolCallback[] toolCallbacks = ToolCallbacks.from(new CommonTool()) ;`    `return ToolCallbackProvider.from(toolCallbacks) ;`  `}``}

如上所述，我们就成功构建了一个仅包含两个外部工具的MCP服务器。

启动服务

• 默认开启了一个/see端点（其实，还有一个消息传输的端点）

• 提示注册了2个工具（也不知道给个空格的）

接下来，我们进行客户端的开发。

2.2 客户端开发

引入依赖

​​​​​​​

<dependency>`  `<groupId>org.springframework.ai</groupId>`  `<artifactId>spring-ai-mcp-client-spring-boot-starter</artifactId>``</dependency>``<dependency>`  `<groupId>org.springframework.ai</groupId>`  `<artifactId>spring-ai-mcp-client-webflux-spring-boot-starter</artifactId>``</dependency>``<dependency>`  `<groupId>com.alibaba.cloud.ai</groupId>`  `<artifactId>spring-ai-alibaba-starter</artifactId>`  `<version>1.0.0-M6.1</version>``</dependency>

注意，这里引入的是mcp-client包。

配置文件

​​​​​​​

spring:`  `ai:`    `mcp:`      `client:`        `enable: true`        `name: ai-mcp-client`        `initialized: true`        `type: ASYNC`        `sse:`          `connections:`            `server1:`              `url: http://localhost:8888

我们配置了一个MCP服务端地址，你可以配置多个按照上面的方式。

完成以上的配置后，我们就可以配置ChatClient，然后进行接口的调用了。

@RestController``@RequestMapping("/tools")``public class ToolController {`  `private final ChatClient chatClient ;`  `public ToolController(ChatClient.Builder aiClientBuilder, ToolCallbackProvider mcpTools) {`    `this.chatClient = aiClientBuilder`        `.defaultTools(mcpTools)`        `.build() ;`  `}`    `@GetMapping("/weather")`  `public ResponseEntity<String> getCurrentWeather(String prompt) {`    `System.err.println(prompt) ;`    `String response = this.chatClient`        `.prompt(prompt)`        `.call().content() ;`    `return ResponseEntity.ok(response) ;`  `}`    `@GetMapping("/ip")`  `public ResponseEntity<String> getIpAddressInfo(String prompt) {`    `System.err.println(prompt) ;`    `String response = this.chatClient`        `.prompt(prompt)`        `.call().content() ;`    `return ResponseEntity.ok(response) ;`  `}``}

在构造函数中，我们直接注入了ToolCallbackProvider，当我们系统启动时会自动的从配置的服务端进行查找有哪些可用的工具。

启动服务

控制台将输出如下从MCP Server获取的工具：

​​​​​​​

i.m.s.M Line:151 - Received JSON message:` `{`  `"jsonrpc": "2.0",`  `"id": "66d12dae-1",`  `"result": {`    `"tools": [`      `{`        `"name": "getCurrentWeather",`        `"description": "获取当前天气预报",`         `"inputSchema": {`           `"type": "object",`           `"properties": {`             `"request": {`               `"type": "object",`               `"properties": {`                 `"city": {`                   `"type": "string",`                   `"description": "城市"`                 `}`               `},`               `"required": ["city"]`             `}`           `},`           `"required": ["request"],`           `"additionalProperties": false`         `}`       `},`       `{`         `"name": "getIpAddressInfo",`         `"description": "获取IP地址详细信息",`         `"inputSchema": {`           `"type": "object",`           `"properties": {`             `"ip": {`               `"type": "string"`             `}`           `},`           `"required": ["ip"],`           `"additionalProperties": false`         `}`       `}`    `]`  `}``}

测试结果

成功！！！

如何学习AI大模型？

作为一名热心肠的互联网老兵，我决定把宝贵的AI知识分享给大家。 至于能学习到多少就看你的学习毅力和能力了 。我已将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

这份完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

一、全套AGI大模型学习路线

AI大模型时代的学习之旅：从基础到前沿，掌握人工智能的核心技能！

二、640套AI大模型报告合集

这套包含640份报告的合集，涵盖了AI大模型的理论研究、技术实现、行业应用等多个方面。无论您是科研人员、工程师，还是对AI大模型感兴趣的爱好者，这套报告合集都将为您提供宝贵的信息和启示。

三、AI大模型经典PDF籍

随着人工智能技术的飞速发展，AI大模型已经成为了当今科技领域的一大热点。这些大型预训练模型，如GPT-3、BERT、XLNet等，以其强大的语言理解和生成能力，正在改变我们对人工智能的认识。 那以下这些PDF籍就是非常不错的学习资源。

四、AI大模型商业化落地方案

作为普通人，入局大模型时代需要持续学习和实践，不断提高自己的技能和认知水平，同时也需要有责任感和伦理意识，为人工智能的健康发展贡献力量。