# 墨迹天气查询

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`），以确保数据的安全性和准确性。