MCP Server Demo Kut

🚀 MCP 服务器演示项目文档

本项目是一个基于 Spring Boot 3.4.4 的 MCP（模型控制协议）服务示例项目，集成了 Spring AI 工具链，可实现智能服务功能。项目中包含基础数值运算、天气查询等服务的实现模板，为开发者提供了便利。

✨ 主要特性

1. 数字服务（NumberService）

• 可进行奇偶数判断。
• 已实现素数检测功能。
• 扩展建议：可添加质因数分解、斐波那契计算等功能。

2. 天气服务（WeatherService）

• 提供天气数据接口，当前使用随机数伪代码实现。实际应用时需对接第三方 API，可参考 OpenWeatherMap API。

3. MCP 工具支持

• 利用 @Tool 注解将服务暴露为标准化工具。
• 借助 @ToolParam 注解定义服务参数。

📦 安装指南

环境要求

• JDK 17
• Maven 3.8+
• IDE（推荐 IntelliJ IDEA）

运行步骤

1. 克隆仓库

git clone https://github.com/liqingdong/mcp-server-demo.git 

2. 构建项目

mvn clean install

3. 使用服务

3.1 使用 STDIO 模式

3.1.1 配置启动命令

java -jar -Dspring.ai.mcp.server.stdio=true target/mcp-server-demo-0.0.1-SNAPSHOT.jar

3.1.2 使用支持 MCP 工具的客户端，例如：Cherry Studio 进行测试

3.2 使用 SSE 模式

3.2.1 配置启动命令（默认访问地址为：http://localhost:8081/sse）

java -jar target/mcp-server-demo-0.0.1-SNAPSHOT.jar 

📚 详细文档

项目结构

src
|-- main
|  |-- java
|  |  `-- cn
|  |    `-- liqingdong
|  |      `-- mcp
|  |        `-- server
|  |          |-- McpApplication.java
|  |          `-- service
|  |            |-- NumberService.java
|  |            `-- WeatherService.java
|  `-- resources
|    `-- application.yml
`-- test
  `-- java
    `-- cn
      `-- liqingdong
        `-- mcp
          `-- server
            |-- McpApplicationTest.java
            `-- SSEMcpTest.java
            `-- STDIOMcpTest.java

核心测试类

🔧 技术细节

开发规范

1. 代码风格：遵循统一的编码规范。
2. 注解使用：通过 @Tool 和 @ToolParam 注解暴露和定义服务参数。
3. 测试覆盖率：确保核心功能的充分测试。

贡献指南

1. 代码提交： Fork 项目并提交 Pull Request。
2. 问题反馈： 在 Issues 中报告问题或建议改进。

📄 许可证

• Spring Boot 版本：3.4.4
• JDK 版本：17+
• 开源协议：MIT License

![ Shields 图标位置 ]