🚀 MCP 服务器演示项目
本项目是基于 Spring Boot 的 Model Context Protocol (MCP) 服务器演示项目，提供了计算器、天气查询、数据模型和 API 接口工具等功能，能满足多样化的使用需求。
🚀 快速开始
前置条件
- JDK 17 或更高版本
- Maven 3.6 或更高版本
- 和风天气 API 密钥（用于天气查询功能）
配置
- 克隆项目到本地。
- 在
src/main/resources/application.yml中配置和风天气 API 密钥。
构建与运行
# 编译项目
mvn clean package
# 运行项目
java -jar target/donts-ai-0.0.1-SNAPSHOT.jar
✨ 主要特性
本项目是一个简单的 MCP 服务器实现，使用 Spring Boot 和 WebFlux 构建，具备以下功能：
- 计算器工具：可计算各种数学表达式，涵盖基本运算（加减乘除）和复杂表达式计算。
- 天气查询工具：能实时查询指定城市的天气信息。
- 系统信息资源：提供操作系统版本、Java 运行时环境版本、应用程序运行时间和当前用户信息等基础信息。
- 数据模型查找工具：根据用户描述查找匹配的数据模型。
- API 接口查找工具：依据数据模型查找对应的 API 接口。
- API 执行工具：根据用户输入构造参数并调用实际接口。
🔧 技术细节
本项目采用的技术栈如下：
- Java 17
- Spring Boot
- Spring WebFlux
- Model Context Protocol (MCP)
- Server-Sent Events (SSE)
💻 使用示例
计算器工具
计算器工具可以处理各种数学表达式，包括基本运算（加减乘除）和复杂表达式计算。示例如下：
2 + 2
(3 * 4) / 2
sqrt(16) + 5
数据模型查找工具
数据模型查找工具可以根据用户的描述或关键词，搜索并返回匹配的数据模型。示例输入如下：
{
"description": "用于预测股票价格",
"keywords": ["时间序列", "回归"]
}
API 接口查找工具
API 接口查找工具可以根据数据模型的名称或功能，搜索并返回对应的 API 接口信息。示例输入如下：
{
"model_name": "用户行为分析模型"
}
API 执行工具
API 执行工具可以根据用户的请求参数，构造请求并调用相应的 API 接口。示例输入如下：
{
"url": "http://example.com/api",
"method": "POST",
"headers": {
"Content-Type": "application/json"
},
"body": {
"name": "test",
"value": "123"
}
}
模拟数据案例
用户模型
{
"model_name": "用户行为分析模型",
"description": "用于分析用户的点击流数据",
"version": "1.0.0"
}
订单模型
{
"model_name": "订单预测模型",
"description": "用于预测未来的订单量",
"version": "2.1.0"
}
📚 详细文档
API 端点
SSE 连接
- 端点：
/sse - 方法：GET
- 描述：建立 SSE 连接，用于接收服务器发送的事件。
消息发送
- 端点：
/mcp/messages - 方法：POST
- 描述：发送消息到 MCP 服务器。
🏗️ 系统架构
本项目的主要组件包括：
- MCP 服务器：负责处理客户端请求和响应。
- 工具实现：包含计算器、天气查询、数据模型查找等功能模块。
- API 接口：提供 RESTful API 服务，支持 SSE 事件推送。
🤝 贡献指南
欢迎参与项目贡献！请按照以下步骤操作：
- Fork 本仓库。
- 创建您的特性分支 (
git checkout -b feature/amazing-feature)。 - 提交您的更改 (
git commit -m 'Add some amazing feature')。 - 推送到分支 (
git push origin feature/amazing-feature)。 - 打开一个 Pull Request。
📄 许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。