Files
higress/plugins/wasm-go/mcp-servers/mcp-weather-query/README_ZH.md
2025-04-16 14:48:53 +08:00

96 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 墨迹天气查询
API认证需要的APP Code请在阿里云API市场申请: https://market.aliyun.com/apimarket/detail/cmapi012364
## 什么是云市场API MCP服务
阿里云云市场是生态伙伴的交易服务平台我们致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务帮助客户高效获取、部署和管理优质生态产品。云市场的API服务涵盖以下几个类目应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI应用与OCR、生活服务。
云市场API依托Higress提供MCP服务您只需在云市场完成订阅并获取AppCode通过Higress MCP Server进行配置即可无缝集成云市场API服务。
## 如何在使用云市场API MCP服务
1. 进入API详情页订阅该API。您可以优先使用免费试用。
2. 前往云市场用户控制台使用阿里云账号登陆后查看已订阅API服务的AppCode并配置到Higress MCP Server的配置中。注意在阿里云市场订阅API服务后您将获得AppCode。对于您订阅的所有API服务此AppCode是相同的您只需使用这一个AppCode即可访问所有已订阅的API服务。
3. 云市场用户控制台会实时展示已订阅的预付费API服务的可用额度如您免费试用额度已用完您可以选择重新订阅。
# 功能简介文档
## 功能简介
MCP服务器 `weather-query` 是一个综合性的天气查询服务旨在为用户提供全面的天气信息。该服务器支持多种天气相关的API工具包括但不限于AQI预报、实时天气数据、未来15天天气预报等。通过这些工具用户可以获取到详细的空气质量指数、天气预警、生活指数等信息帮助用户更好地规划日常活动。
## 工具简介
### 1. AQI预报5天
- **用途**提供未来5天内的空气质量指数AQI数据。
- **使用场景**:适用于需要了解未来几天内空气质量变化趋势的用户或应用程序,如旅游计划、户外活动安排等。
- **请求参数**
- `lat` (纬度):必填项,用于指定查询地点的地理坐标。
- `lon` (经度):必填项,与纬度配合使用。
- `token`:默认参数,必须填写,用于身份验证。
### 2. 天气实况
- **用途**:提供当前位置的实时天气数据,包括温度、湿度、风速等多个气象要素。
- **使用场景**适合需要即时天气信息的应用程序例如天气预报App、智能穿戴设备等。
- **请求参数**
- `lat` (纬度):必填项。
- `lon` (经度):必填项。
- `token`:必填项,用于认证。
### 3. 天气预报15天
- **用途**预测未来15天的天气情况包括每日的最高最低气温、天气状况等。
- **使用场景**:适用于长期旅行规划、农业种植周期管理等领域。
- **请求参数**
- `lat` (纬度):必需。
- `lon` (经度):必需。
- `token`:必需。
### 4. 天气预报24小时
- **用途**提供接下来24小时内每小时的天气预报。
- **使用场景**:对于需要精确短期天气信息的服务非常有用,比如航班调度、户外赛事组织等。
- **请求参数**
- `lat` (纬度):必要。
- `lon` (经度):必要。
- `token`:必要。
### 5. 天气预警
- **用途**:发布针对特定地区的极端天气警告信息。
- **使用场景**:灾害预防系统、公共安全通知等。
- **请求参数**
- `lat` (纬度):需提供。
- `lon` (经度):需提供。
- `token`:需提供。
### 6. 生活指数
- **用途**:根据当前天气条件给出穿衣建议、洗车指数等生活指南。
- **使用场景**:生活方式应用、健康管理软件等。
- **请求参数**
- `lat` (纬度):是必需的。
- `lon` (经度):是必需的。
- `token`:是必需的。
### 7. 短时预报
- **用途**:提供接下来两小时内的详细天气预报。
- **使用场景**:适用于需要短时间内天气更新的情况,如临时户外活动。
- **请求参数**
- `lat` (纬度):必须输入。
- `lon` (经度):必须输入。
- `token`:必须输入。
### 8. 空气质量指数
- **用途**:显示当前地区的主要污染物浓度及总体空气质量指数。
- **使用场景**:环保监测、健康咨询等。
- **请求参数**
- `lat` (纬度):不可缺。
- `lon` (经度):不可缺。
- `token`:不可缺。
### 9. 限行数据
- **用途**:提供某些城市基于尾号限行政策的车辆通行限制信息。
- **使用场景**:交通管理、出行助手类应用。
- **请求参数**
- `lat` (纬度):重要参数之一。
- `lon` (经度):重要参数之一。
- `token`:重要参数之一。
以上每个工具都通过POST方法调用相应的API并且所有请求都需要包含基本的身份验证信息`token`),以确保数据的安全性和准确性。