--- highlight: a11y-dark --- 目前网上能看到的**MCP Server**基本上都是基于**Python**或者**nodejs** ，虽然也有Java版本的MCP SDK，但是鲜有基于Java开发的。不过尽管如此，作为Java开发中的顶级框架Spring已经基于**MCP SDK**在进行**Spring AI**框架开发了，不过目前还没有正式发布，本文将使用**Spring AI MCP**做一个简单的查询数据库的**MCP Server**。 ## 引入依赖目前为止**Spring AI MCP**相关依赖最新的版本号是**1.0.0-M7**，我试了通过SSE的方式访问是不通的，如果有人测试访问是通的，麻烦给我留个言。sdtio的方式没有试过，感兴趣的可以试一下。所以本文还是基于**1.0.0-M6**的版本，具体依赖如下： ```xml 4.0.0 org.springframework.boot spring-boot-starter-parent 3.4.4 site.sunlong jdbc-mcp-server 0.0.1-SNAPSHOT jdbc-mcp-server jdbc-mcp-server 17

1.0.0-M6

org.springframework.ai spring-ai-mcp-server-webmvc-spring-boot-starter org.springframework.ai spring-ai-bom ${spring-ai.version} pom import org.springframework.boot spring-boot-maven-plugin ``` 从传输协议角度，spring-ai-mcp-server 相关依赖分为两类： 1. **STDIO（标准输入输出）** ：主要用于本地或进程内通信，通过标准输入输出流与客户端交互。对应的依赖为 ```xml org.springframework.ai spring-ai-mcp-server-spring-boot-starter 1.0.0-M6 ``` 2. 基于 Web 的 **SSE（Server-Sent Events）**: 通过 HTTP/SSE 协议提供服务，适合 Web 环境或需要通过 HTTP 接口与客户端通信的场景。**SSE** 依赖又分为两类，区别在于 **webflux** 是非阻塞模型、响应式编程： ```xml org.springframework.ai spring-ai-mcp-server-webflux-spring-boot-starter 1.0.0-M6 org.springframework.ai spring-ai-mcp-server-webmvc-spring-boot-starter 1.0.0-M6 ``` 配置文件： ```bash spring.ai.mcp.server.name=jdbc-mcp-server # 是否使用 stdio 传输协议，默认false spring.ai.mcp.server.stdio=false spring.data.jdbc.dialect=mysql spring.datasource.url=jdbc:mysql://localhost:3306/springboot_practice?useSSL=false&serverTimezone=UTC spring.datasource.username=root spring.datasource.password=123456 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver ``` ## 写工具依赖和配置都准备好了以后，剩下的就是动手开发了。写工具分两步，编写工具和注册工具。 1. **使用@Tool注解编写工具** * `@Tool` 注解标记这个方法是一个工具，通过 `description` 属性告诉大模型这个工具是做什么的，其实就是提示词，大模型会根据自己的理解调用这个工具，所以这个描述很重要。 * `@ToolParam`：从名字可以看出来，就是工具调用时需要传什么参数 ```bash @Service public class JdbcQueryService { @Autowired private JdbcTemplate jdbcTemplate; @Tool(description = "查询数据库中所有的表") public List> queryAllTables(){ String sql = "SELECT TABLE_NAME , TABLE_COMMENT FROM information_schema.tables WHERE TABLE_SCHEMA = DATABASE()"; return jdbcTemplate.queryForList(sql); } @Tool(description = "查询数据库中的表的数据") public List> queryTable(@ToolParam(description = "表名") String tableName){ String sql = "SELECT * FROM " + tableName; return jdbcTemplate.queryForList(sql); } } ``` 2. **注册工具** ```java @Configuration public class McpConfig { @Bean ToolCallbackProvider jdbcQueryTools(JdbcQueryService jdbcQueryService) { return MethodToolCallbackProvider .builder() .toolObjects(jdbcQueryService) .build(); } } ``` 启动服务端，控制台打印如下日志表明工具注入成功，我是写了2个工具，所以tools是2。 ![在这里插入图片描述](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/918d391b0ce5428da756da28d4f9c215~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg57Si56CB55CG:q75.awebp?rk3s=f64ab15b&x-expires=1774297254&x-signature=VSDhvBmoNSviQFCVSUlSxIDB%2BhM%3D) ## 测试 #### 客户端配置启动之后就可以通过客户端调用**MCP Server**了，我这依旧使用**Cherry Studio**。 ![Cherry Studio中添加MCP 服务器](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/a8162d9cd0bc4ae0b90f78b066b9e306~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg57Si56CB55CG:q75.awebp?rk3s=f64ab15b&x-expires=1774297254&x-signature=d%2FwrZccNT8uEFW2MnzPit6YUxqo%3D) 连接上之后可用工具列表就可以看到工具及描述了，同时在控制台也可以看到MCP 客户端传过来的信息： ```bash Client initialize request - Protocol: 2024-11-05, Capabilities: ClientCapabilities[experimental=null, roots=null, sampling=null], Info: Implementation[name=Cherry Studio, version=1.2.1] ``` #### 调用MCP 服务端对话框界面选择**MCP服务器** ，选择刚才添加的MCP 服务端，然后就可以进行对话了。 ![](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/24f1ac024566489f9f08aec1f5971c60~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg57Si56CB55CG:q75.awebp?rk3s=f64ab15b&x-expires=1774297254&x-signature=Ep8GKCMS7Pe4h7p4E%2B%2FHWAtluFY%3D) 下面两个图是我对话的截图及大模型的输出，因为太长就只截图了部分界面，可以看到大模型的确是调用了工具并将数据库中有哪些表和该表的数据也给返回了。 ![查询数据库中所有的表](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/ddb3c832546947f29944f7f255b83421~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg57Si56CB55CG:q75.awebp?rk3s=f64ab15b&x-expires=1774297254&x-signature=wT8i932tj9%2FT04QD%2BoUnmYfF33g%3D) ![查询数据库中的表的数据](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/cda91ed2b9294f319034a4a735bca6f5~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg57Si56CB55CG:q75.awebp?rk3s=f64ab15b&x-expires=1774297254&x-signature=8qVzMaWq7LHKLtbmLDUbcJsqXYY%3D) # 遇到的问题因为还没有正式发布，所以会存在一些问题。 **1. 连接超时** 在客户端连接服务端时，总是提示超时，而且在调用时会特别慢，会超时连接很多次。 ![](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/031fefb2b88e4b1c8a13c4164dd6dda9~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg57Si56CB55CG:q75.awebp?rk3s=f64ab15b&x-expires=1774297254&x-signature=7zde%2F7rJxlGcJgA%2FUZxsymFhJ3Q%3D) **2. 会话发送失败** 客户端连接过来之后发送会话会一直失败 ![](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/5a1fdd5aabb3409f817ab502bde091e5~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg57Si56CB55CG:q75.awebp?rk3s=f64ab15b&x-expires=1774297254&x-signature=5vWs6RXQgY%2B1utNbu6hUV7Ie9BU%3D) # 总结从我们的实现过程来看，实现一个MCP服务端并不复杂。目前来说 **MCP**也是属于起步阶段，生态还有待完善，所以 **Spring AI MCP**也还不成熟，当然后面随着**MCP**的起飞，**Spring AI MCP**也会起飞的，所以让子弹再飞一会儿吧。下一篇将介绍一下，**Spring AI MCP Client** 怎么入门使用。