关于 MCP Server Demo 项目文档
这是一个基于 Spring Boot 和 Spring AI 的 MCP 服务示例，面向学习或搭建 MCP 服务的开发者。项目包含数值与天气服务模板，并演示 STDIO 和 SSE 两种连接模式。
主要功能
- 01基于 Spring Boot 3.4.4
- 02提供奇偶数判断与素数检测
- 03包含天气服务示例
- 04支持 STDIO 与 SSE 模式
- 05使用注解暴露工具和参数
适用场景
- 01学习 Spring AI MCP 服务结构
- 02测试不同 MCP 连接模式
- 03基于示例扩展服务工具
MCP 相关
该项目作为 MCP 服务，通过 `@Tool` 和 `@ToolParam` 暴露工具与参数，可使用 STDIO 或 SSE 模式供兼容客户端连接。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
来自项目 READMEMCP Server Demo 项目文档
项目简介
这是一个基于Spring Boot 3.4.4的MCP（Model Control Protocol）服务示例项目，集成Spring AI工具链实现智能服务功能。项目包含基础数值运算、天气查询等服务的实现模板。
核心功能
1. 数字服务（NumberService）
- 奇偶数判断
- 素数检测（已实现）
- 扩展建议：可添加质因数分解、斐波那契计算等
2. 天气服务（WeatherService）
- 天气数据接口（当前使用随机数伪代码。真实需对接第三方API实现，可参考OpenWeatherMap API）
3. MCP工具支持
- 通过
@Tool注解暴露服务为标准化工具 - 通过
@ToolParam注解定义服务参数
项目结构
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
快速开始
环境要求
- 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
核心测试类
| 测试类名 | 测试内容 |
|---|---|
McpApplicationTest | 应用上下文加载验证 |
SSEMcpTest/StdioMcpTest | 不同协议的MCP服务测试 |
开发规范
- 代码风格：遵循Spring官方编码规范
- 工具注解：所有服务方法需用
@Tool标注，参数需用@ToolParam标注 - 测试覆盖率：核心功能需达到80%+单元测试覆盖
贡献指南
- Fork仓库 → 创建功能分支
- 实现新功能/修复问题
- 添加对应单元测试
- 提交Pull Request至
main分支
项目状态
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。