MCP Server Demo 项目文档
好的,这是 "一个基于Spring Boot 的MCP(Model Control Protocol)服务示例项目" 的中文翻译: **一个基于 Spring Boot 的 MCP (模型控制协议) 服务示例项目** This translation is quite literal and accurate. It maintains the technical terms in English as they are commonly used in Chinese technical contexts.
liqingdong
README
MCP 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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于Spring Boot 3.4.4的MCP(Model Control Protocol)服务示例项目,集成Spring AI工具链实现智能服务功能。项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方API实现,可参考[OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP工具支持**
- 通过`@Tool`注解暴露服务为标准化工具
- 通过`@ToolParam`注解定义服务参数
---
## 项目结构
```text
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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于Spring Boot 3.4.4 的 MCP(Model Control Protocol)服务示例项目,集成 Spring AI 工具链实现智能服务功能。项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方 API 实现,可参考 [OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP 工具支持**
- 通过 `@Tool` 注解暴露服务为标准化工具
- 通过 `@ToolParam` 注解定义服务参数
---
## 项目结构
```text
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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于 Spring Boot 3.4.4 的 MCP(Model Control Protocol)服务示例项目,集成 Spring AI 工具链实现智能服务功能。项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方 API 实现,可参考 [OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP 工具支持**
- 通过 `@Tool` 注解暴露服务为标准化工具
- 通过 `@ToolParam` 注解定义服务参数
---
## 项目结构
```text
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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于 Spring Boot 3.4.4 的 MCP(Model Control Protocol)服务示例项目,集成 Spring AI 工具链实现智能服务功能。 项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方 API 实现,可参考 [OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP 工具支持**
- 通过 `@Tool` 注解暴露服务为标准化工具
- 通过 `@ToolParam` 注解定义服务参数
---
## 项目结构
```text
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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于 Spring Boot 3.4.4 的 MCP(Model Control Protocol)服务示例项目,集成了 Spring AI 工具链,实现了智能服务功能。 项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方 API 实现,可参考 [OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP 工具支持**
- 通过 `@Tool` 注解将服务暴露为标准化工具
- 通过 `@ToolParam` 注解定义服务参数
---
## 项目结构
```text
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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于 Spring Boot 3.4.4 的 MCP(Model Control Protocol)服务示例项目,集成了 Spring AI 工具链,实现了智能服务功能。项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方 API 实现,可参考 [OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP 工具支持**
- 通过 `@Tool` 注解将服务暴露为标准化工具
- 通过 `@ToolParam` 注解定义服务参数
---
## 项目结构
```text
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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于 Spring Boot 3.4.4 的 MCP(Model Control Protocol)服务示例项目,集成了 Spring AI 工具链,实现了智能服务功能。项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方 API 实现,可参考 [OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP 工具支持**
- 通过 `@Tool` 注解将服务暴露为标准化工具
- 通过 `@ToolParam` 注解定义服务参数
---
## 项目结构
```text
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
分支
项目状态
# MCP Server Demo 项目文档
## 项目简介
这是一个基于 Spring Boot 3.4.4 的 MCP(Model Control Protocol)服务示例项目,集成了 Spring AI 工具链,实现了智能服务功能。项目包含基础数值运算、天气查询等服务的实现模板。
## 核心功能
### 1. **数字服务**(`NumberService`)
- 奇偶数判断
- 素数检测(已实现)
- 扩展建议:可添加质因数分解、斐波那契计算等
### 2. **天气服务**(`WeatherService`)
- 天气数据接口(当前使用随机数伪代码。真实需对接第三方 API 实现,可参考 [OpenWeatherMap API](https://openweathermap.org/api))
### 3. **MCP 工具支持**
- 通过 `@Tool` 注解将服务暴露为标准化工具
- 通过 `@ToolParam` 注解定义服务参数
---
## 项目结构
```text
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
推荐服务器
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
MCP Package Docs Server
促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。
Claude Code MCP
一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。
@kazuph/mcp-taskmanager
用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。
mermaid-mcp-server
一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。
Jira-Context-MCP
MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

Linear MCP Server
一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

Sequential Thinking MCP Server
这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。
Curri MCP Server
通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。