MCP Server Demo 项目文档

MCP Server Demo 项目文档

site icon
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协议实现智能服务功能,包括基础数值运算和天气查询等。

核心功能

  1. 数字服务(NumberService)
  2. 奇偶数判断
  3. 素数检测
  4. 扩展建议:可添加质因数分解、斐波那契计算等

  5. 天气服务(WeatherService)

  6. 天气数据接口(当前使用随机数伪代码,真实需对接第三方API实现)

  7. MCP工具支持

  8. 通过@Tool注解暴露服务为标准化工具
  9. 通过@ToolParam注解定义服务参数

适用场景

  • 开发人员学习MCP协议和Spring Boot集成
  • 快速构建基于MCP协议的智能服务
  • 实现基础数值运算和天气查询服务

工具列表

  • NumberService:提供奇偶数判断、素数检测等数字运算功能。
  • WeatherService:提供天气数据查询功能(需对接第三方API)。

常见问题解答

  1. 如何扩展功能?
  2. 可以通过添加新的服务类并使用@Tool注解暴露为工具。

  3. 如何对接真实天气API?

  4. 参考OpenWeatherMap API等第三方服务进行对接。

使用教程

使用依赖

  • JDK 17
  • Maven 3.8+
  • IDE(推荐IntelliJ IDEA)

安装教程

  1. 克隆仓库 bash git clone https://github.com/liqingdong/mcp-server-demo.git

  2. 构建项目 bash mvn clean install

  3. 使用服务

  4. STDIO模式 bash java -jar -Dspring.ai.mcp.server.stdio=true target/mcp-server-demo-0.0.1-SNAPSHOT.jar
  5. SSE模式(默认访问地址为:http://localhost:8081/sse) bash java -jar target/mcp-server-demo-0.0.1-SNAPSHOT.jar

调试方式

  • 使用支持MCP工具的客户端(如Cherry Studio)进行测试。
  • 运行测试类SSEMcpTestStdioMcpTest进行不同协议的MCP服务测试。

许可证

None