Donts MCP Server Demo

🚀 MCP 服务器演示项目

本项目是基于 Spring Boot 的 Model Context Protocol (MCP) 服务器演示项目，提供了计算器、天气查询、数据模型和 API 接口工具等功能，能满足多样化的使用需求。

🚀 快速开始

前置条件

• JDK 17 或更高版本
• Maven 3.6 或更高版本
• 和风天气 API 密钥（用于天气查询功能）

配置

1. 克隆项目到本地。
2. 在 src/main/resources/application.yml 中配置和风天气 API 密钥。

构建与运行

# 编译项目
mvn clean package

# 运行项目
java -jar target/donts-ai-0.0.1-SNAPSHOT.jar

✨ 主要特性

本项目是一个简单的 MCP 服务器实现，使用 Spring Boot 和 WebFlux 构建，具备以下功能：

1. 计算器工具：可计算各种数学表达式，涵盖基本运算（加减乘除）和复杂表达式计算。
2. 天气查询工具：能实时查询指定城市的天气信息。
3. 系统信息资源：提供操作系统版本、Java 运行时环境版本、应用程序运行时间和当前用户信息等基础信息。
4. 数据模型查找工具：根据用户描述查找匹配的数据模型。
5. API 接口查找工具：依据数据模型查找对应的 API 接口。
6. 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 事件推送。

🤝 贡献指南

欢迎参与项目贡献！请按照以下步骤操作：

1. Fork 本仓库。
2. 创建您的特性分支 (git checkout -b feature/amazing-feature)。
3. 提交您的更改 (git commit -m 'Add some amazing feature')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 打开一个 Pull Request。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。