
MCP Server Demo 项目文档

2025.03.27
1
Java智能服务数值运算天气查询其它
MCP Server Demo 是一个基于Spring Boot 3.4.4的MCP(Model Control Protocol)服务示例项目,集成了Spring AI工具链以实现智能服务功能。该项目提供了基础数值运算和天气查询等服务的实现模板,通过`@Tool`和`@ToolParam`注解将服务暴露为标准化工具,便于客户端调用。
View on GitHub
Overview
基本能力
产品定位
MCP Server Demo 是一个基于Spring Boot的MCP服务示例项目,旨在展示如何通过MCP协议实现智能服务功能,包括基础数值运算和天气查询等。
核心功能
- 数字服务(NumberService)
- 奇偶数判断
- 素数检测
-
扩展建议:可添加质因数分解、斐波那契计算等
-
天气服务(WeatherService)
-
天气数据接口(当前使用随机数伪代码,真实需对接第三方API实现)
-
MCP工具支持
- 通过
@Tool
注解暴露服务为标准化工具 - 通过
@ToolParam
注解定义服务参数
适用场景
- 开发人员学习MCP协议和Spring Boot集成
- 快速构建基于MCP协议的智能服务
- 实现基础数值运算和天气查询服务
工具列表
- NumberService:提供奇偶数判断、素数检测等数字运算功能。
- WeatherService:提供天气数据查询功能(需对接第三方API)。
常见问题解答
- 如何扩展功能?
-
可以通过添加新的服务类并使用
@Tool
注解暴露为工具。 -
如何对接真实天气API?
- 参考OpenWeatherMap API等第三方服务进行对接。
使用教程
使用依赖
- JDK 17
- Maven 3.8+
- IDE(推荐IntelliJ IDEA)
安装教程
-
克隆仓库
bash git clone https://github.com/liqingdong/mcp-server-demo.git
-
构建项目
bash mvn clean install
-
使用服务
- STDIO模式
bash java -jar -Dspring.ai.mcp.server.stdio=true target/mcp-server-demo-0.0.1-SNAPSHOT.jar
- SSE模式(默认访问地址为:http://localhost:8081/sse)
bash java -jar target/mcp-server-demo-0.0.1-SNAPSHOT.jar
调试方式
- 使用支持MCP工具的客户端(如Cherry Studio)进行测试。
- 运行测试类
SSEMcpTest
或StdioMcpTest
进行不同协议的MCP服务测试。
许可证
None