IT评测·应用市场-qidao123.com技术社区

标题: 必看！SpringAI轻松构建MCP Client-Server架构 [打印本页]

---

作者: 数据人与超自然意识    时间: 2025-4-11 01:20
标题: 必看！SpringAI轻松构建MCP Client-Server架构
MCP 这个概念信赖各人已经听了无数次了，但差别人会有差别的解释，你大概也是听得云里雾里的。
不过没关系，今天这篇内容会通过 Spring AI 给你实现一个 MCP 的 Client 和 Server 架构，让你彻底搞懂 MCP 的概念，以及学会 MCP 的开发技能。
什么是MCP？

MCP 是 Model Context Protocol，模子上下文协议，它是由 Anthropic（Claude 大模子母公司）提出的开放协议，用于大模子连接外部“数据源”的一种协议。
它可以通俗的理解为 Java 界的 Spring Cloud Openfeign，只不过 Openfeign 是用于微服务通讯的，而 MCP 用于大模子通讯的，但它们都是为了通讯获取某项数据的一种机制，如下图所示：

为什么需要MCP？

MCP 存在的意义是它办理了大模子时代最关键的三个问题：数据孤岛**、开发低效和生态****碎片化**等问题。
1.冲破数据孤岛，让AI“连接万物”

大模子自己无法直接访问实时数据或当地资源（如数据库、文件系统），传统方式需要手动复制粘贴或定制接口。MCP 通过标准化协议，让大模子像“插USB”一样直接调用外部工具和数据源，例如：

• 查天气时自动调用景象 API，无需手动输入数据。
  
• 分析企业数据时直接连接内部数据库，避免信息割裂。
  

2.低落开发成本，一次适配全部场景

在之前每个大模子（如 DeepSeek、ChatGPT）需要为每个工具单独开发接口（Function Calling），导致重复劳动，MCP 通过统一协议：

• 开发者只需写一次 MCP 服务端，全部兼容 MCP 的模子都能调用。
  
• 用户无需关心技术细节，大模子可直接操纵当地文件、设计软件等。
  

3.提拔安全性与互操纵性

• 安全性：MCP 内置权限控制和加密机制，比直接开放数据库更安全。
  
• 生态统一：类似 USB 接口，MCP 让差别厂商的工具能“即插即用”，避免生态分裂。
  

4.推动AIAgent的进化

MCP 让大模子从“被动应答”变为“主动调用工具”，例如：

• 自动抓取网页消息增补实时知识。
  
• 打开 Idea 编写一个“Hello World”的代码。
  

MCP 的诞生，相当于为AI世界创建了“通用语言”，让模子、数据和工具能高效协作，终极释放大模子的全部潜力。
MCP组成和实行流程

MCP 架构分为以下 3 部门：

• 客户端：大模子应用（如 DeepSeek、ChatGPT）发起请求。
  
• 服务器：中央层，连接具体工具（如数据库、设计软件）。
  
• 资源：具体的数据或工具（如 Exce l文件、网页 API）。
  

运行流程：

• 用户提问。
  
• 大模子通过 MCP 客户端发送请求。
  
• MCP 服务器吸收指令。
  
• 调用对应工具（如数据库）实行。
  
• 返回效果给大模子。
  
• 生成终极回答。
  

Spring AI MCP 介绍

Spring AI MCP 是通过 Spring Boot 集成扩展了 MCP 的 Java SDK（开发工具），它同时提供了 Spring Boot 客户端和服务器的启动器，方便使用 Spring AI MCP 快速开发 AI 应用程序。
Spring AI MCP 实战

当前案例中，我们使用 MCP 实现一个天气查询小助手，其中包罗的重要角色有：

• MCP Server：MCP 服务提供方，提供天气查询功能。
  
• MCP Client：MCP 客户端（大模子端）我们对接 DeepSeek LLM 实现对 MCP Server 的调用，从而实现天气预报的查询功能。
  

具体交互流程如下：

实现 MCP Server 代码编写

MCP Server 重要实现步骤如下：

• 添加 MCP Server 依赖。
  
• 设置 MCP 配置信息。
  
• 编写 MCP Server 服务代码。
  
• 将 MCP Server 举行袒露设置。
  

关键实当代码如下。
添加 MCP Server 依赖

1. <dependencies>
2.   <dependency>
3.     <groupId>org.springframework.ai</groupId>
4.     <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
5.   </dependency>
6. </dependencies>
8. <repositories>
9.   <repository>
10.     <name>Central Portal Snapshots</name>
11.     <id>central-portal-snapshots</id>
12.     <url>https://central.sonatype.com/repository/maven-snapshots/</url>
13.     <releases>
14.       <enabled>false</enabled>
15.     </releases>
16.     <snapshots>
17.       <enabled>true</enabled>
18.     </snapshots>
19.   </repository>
20.   <repository>
21.     <id>spring-milestones</id>
22.     <name>Spring Milestones</name>
23.     <url>https://repo.spring.io/milestone</url>
24.     <snapshots>
25.       <enabled>false</enabled>
26.     </snapshots>
27.   </repository>
28.   <repository>
29.     <id>spring-snapshots</id>
30.     <name>Spring Snapshots</name>
31.     <url>https://repo.spring.io/snapshot</url>
32.     <releases>
33.       <enabled>false</enabled>
34.     </releases>
35.   </repository>
36. </repositories>

复制代码

MCP Server 依赖有三种类型：

• 标准输入/输出 （STDIO）：spring-ai-starter-mcp-server
  
• Spring MVC（服务器发送的变乱）：spring-ai-starter-mcp-server-webmvc
  
• Spring WebFlux（响应式 SSE）：spring-ai-starter-mcp-server-webflux
  

设置 MCP 配置信息

MCP Server 包罗以下配置信息：
配置项描述默认值enabled启用/禁用 MCP 服务器TRUEstdio启用/禁用 stdio 传输FALSEname用于标识的服务器名称mcp-serverversion服务器版本1.0.0type服务器类型 （SYNC/ASYNC）SYNCresource-change-notification启用资源更改关照TRUEprompt-change-notification启用提示更改关照TRUEtool-change-notification启用工具更改关照TRUEtool-response-mime-type（可选）每个工具名称的响应 MIME 类型。例如，将 mime 类型与工具名称相关联spring.ai.mcp.server.tool-response-mime-type.generateImage=image/pngimage/pnggenerateImage()-sse-message-endpointWeb 传输的 SSE 终端节点路径/mcp/message 其中 MCP Server 又分为以下两种类型。
服务器类型

• 同步服务器：默认服务器类型，它专为应用程序中的简单请求-响应模式而设计。要启用此服务器类型，请在您的配置中设置。 激活后，它会自动处理同步工具规格的配置，spring.ai.mcp.server.type=SYNC。
  
• 异步服务器：异步服务器实现使用非壅闭作并针对非壅闭作举行了优化。要启用此服务器类型，请使用配置您的应用程序。此服务器类型会自动设置具有内置 Project Reactor 支持的异步工具规范，spring.ai.mcp.server.type=ASYNC。
  

编写 MCP Server 服务代码

编写天气预报查询伪代码：

1. import org.springframework.ai.tool.annotation.Tool;
2. import org.springframework.stereotype.Service;
4. import java.util.Map;
6. @Service
7. public class WeatherService {
9.     @Tool(description = "根据城市名称获取天气预报")
10.     public String getWeatherByCity(String city) {
11.         Map<String, String> mockData = Map.of(
12.             "西安", "晴天",
13.             "北京", "小雨",
14.             "上海", "大雨"
15.         );
16.         return mockData.getOrDefault(city, "抱歉：未查询到对应城市！");
17.     }
19. }

复制代码

将服务袒露出去

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

复制代码

如许 MCP Server 就编写完成了。
实现 MCP Client 代码编写

MCP Client 重要实现步骤如下：

• 添加 MCP Client 相关依赖。
  
• 设置配置信息。
  
• 设置 ChatClient 对象（调用 MCP Server）。
  
• 编写测试代码调用 MCP Server。
  

焦点实当代码如下：

1. import org.springframework.ai.chat.client.ChatClient;
2. import org.springframework.beans.factory.annotation.Autowired;
3. import org.springframework.web.bind.annotation.RequestMapping;
4. import org.springframework.web.bind.annotation.RequestParam;
5. import org.springframework.web.bind.annotation.RestController;
7. @RestController
8. public class ClientController {
10.     @Autowired
11.     private ChatClient chatClient;
13.     @RequestMapping("/chat")
14.     public String chat(@RequestParam(value = "msg",defaultValue = "今天天气如何？") String msg) {
15.         String response = chatClient.prompt()
16.         .user(msg)
17.         .call()
18.         .content();
19.         System.out.println("响应结果: " + response);
20.         return response;
21.     }
23. }

复制代码

终极实行效果如下：

因为 MCP Server 只配置了 3 个城市，所以查询效果和预期相符：

   想要获取完整案例的同砚加V：vipStone【备注MCP】
  小结

到这里使用 Spring AI 就实现了 MCP Client 和 Server 的调用了，可以看出 MCP 的推出只是为了加强大模子的能力的，有了 MCP 协议之后，任何大模子就可以调用恣意实现了 MCP Server 的服务了，如许就无线扩充了大模子的能力，为 AI 的发展提供了标准的协议和便利的对接。
   本文已收录到我的面试小站 www.javacn.site，其中包罗的内容有：场景题、并发编程、MySQL、Redis、Spring、Spring MVC、Spring Boot、Spring Cloud、MyBatis、JVM、设计模式、消息队列等模块。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 IT评测·应用市场-qidao123.com技术社区 (https://dis.qidao123.com/)

Powered by Discuz! X3.4