mirror-earth-mcp 0.2.0__tar.gz

mirror_earth_mcp-0.2.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: mirror-earth-mcp
+Version: 0.2.0
+Summary: Model Context Protocol server for Mirror Earth weather data.
+Project-URL: Homepage, https://gitee.com/gfyml/mirror-earth-mcp
+Project-URL: Repository, https://gitee.com/gfyml/mirror-earth-mcp.git
+Author: Mirror Earth
+License: MIT
+Keywords: mcp,mirror-earth,weather
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Mirror Earth MCP
+
+`mirror-earth-mcp` is a Python implementation of a Model Context Protocol (MCP) server for Mirror Earth weather data. It provides weather queries, model and variable catalogs, geocoding, local Markdown references, and batch-export task management.
+
+## Requirements
+
+- Python 3.9 or newer
+- [uv](https://docs.astral.sh/uv/)
+- A Mirror Earth API key for authenticated weather and batch-export tools
+
+`geocode` and `reverse_geocode` use the public geocoding endpoint and do not require an API key.
+
+## Install and Run
+
+Run the published package directly with `uvx`:
+
+```powershell
+uvx --from mirror-earth-mcp mirror-earth-mcp
+```
+
+Set `MIRROR_EARTH_API_KEY` in the MCP client's environment. The server uses stdio transport and writes JSON-RPC responses only to standard output.
+
+## MCP Configuration
+
+```json
+{
+  "mcpServers": {
+    "mirror-earth": {
+      "command": "uvx",
+      "args": ["--from", "mirror-earth-mcp", "mirror-earth-mcp"],
+      "env": {
+        "MIRROR_EARTH_API_KEY": "YOUR_MIRROR_EARTH_API_KEY"
+      }
+    }
+  }
+}
+```
+
+For Codex CLI:
+
+```powershell
+codex mcp add mirror-earth --env MIRROR_EARTH_API_KEY=YOUR_MIRROR_EARTH_API_KEY -- uvx --from mirror-earth-mcp mirror-earth-mcp
+```
+
+## Tools
+
+| Tool | Purpose |
+| --- | --- |
+| `list_models` | List forecast, historical, and archive forecast models. |
+| `get_model_details` | Inspect model metadata, variables, and pressure levels. |
+| `list_variables` | List hourly, daily, or monthly variables. |
+| `get_forecast` | Query weather forecasts by coordinates. |
+| `get_historical_weather` | Query ERA5 historical weather data. |
+| `get_archive_forecast` | Query a past model forecast run. |
+| `get_seamless_weather` | Query continuous ERA5 and ECMWF data. |
+| `geocode` / `reverse_geocode` | Resolve place names and coordinates. |
+| `get_batch_usage` | Inspect batch-export quota and usage. |
+| `estimate_batch_export` / `create_batch_export` | Estimate and create batch exports. |
+| `get_batch_task` / `list_batch_tasks` / `cancel_batch_task` | Manage batch-export tasks. |
+
+The server also exposes bundled API and model documentation as `mirror-earth://references/...` MCP resources.
+
+## Development
+
+```powershell
+uv sync
+uv run pytest
+uv build
+```
+
+Build artifacts are written to `dist/`. To publish a new version, authenticate with a PyPI token using the `UV_PUBLISH_TOKEN` environment variable and run:
+
+```powershell
+uv publish
+```

mirror_earth_mcp-0.2.0/README.md

@@ -0,0 +1,75 @@
+# Mirror Earth MCP
+
+`mirror-earth-mcp` is a Python implementation of a Model Context Protocol (MCP) server for Mirror Earth weather data. It provides weather queries, model and variable catalogs, geocoding, local Markdown references, and batch-export task management.
+
+## Requirements
+
+- Python 3.9 or newer
+- [uv](https://docs.astral.sh/uv/)
+- A Mirror Earth API key for authenticated weather and batch-export tools
+
+`geocode` and `reverse_geocode` use the public geocoding endpoint and do not require an API key.
+
+## Install and Run
+
+Run the published package directly with `uvx`:
+
+```powershell
+uvx --from mirror-earth-mcp mirror-earth-mcp
+```
+
+Set `MIRROR_EARTH_API_KEY` in the MCP client's environment. The server uses stdio transport and writes JSON-RPC responses only to standard output.
+
+## MCP Configuration
+
+```json
+{
+  "mcpServers": {
+    "mirror-earth": {
+      "command": "uvx",
+      "args": ["--from", "mirror-earth-mcp", "mirror-earth-mcp"],
+      "env": {
+        "MIRROR_EARTH_API_KEY": "YOUR_MIRROR_EARTH_API_KEY"
+      }
+    }
+  }
+}
+```
+
+For Codex CLI:
+
+```powershell
+codex mcp add mirror-earth --env MIRROR_EARTH_API_KEY=YOUR_MIRROR_EARTH_API_KEY -- uvx --from mirror-earth-mcp mirror-earth-mcp
+```
+
+## Tools
+
+| Tool | Purpose |
+| --- | --- |
+| `list_models` | List forecast, historical, and archive forecast models. |
+| `get_model_details` | Inspect model metadata, variables, and pressure levels. |
+| `list_variables` | List hourly, daily, or monthly variables. |
+| `get_forecast` | Query weather forecasts by coordinates. |
+| `get_historical_weather` | Query ERA5 historical weather data. |
+| `get_archive_forecast` | Query a past model forecast run. |
+| `get_seamless_weather` | Query continuous ERA5 and ECMWF data. |
+| `geocode` / `reverse_geocode` | Resolve place names and coordinates. |
+| `get_batch_usage` | Inspect batch-export quota and usage. |
+| `estimate_batch_export` / `create_batch_export` | Estimate and create batch exports. |
+| `get_batch_task` / `list_batch_tasks` / `cancel_batch_task` | Manage batch-export tasks. |
+
+The server also exposes bundled API and model documentation as `mirror-earth://references/...` MCP resources.
+
+## Development
+
+```powershell
+uv sync
+uv run pytest
+uv build
+```
+
+Build artifacts are written to `dist/`. To publish a new version, authenticate with a PyPI token using the `UV_PUBLISH_TOKEN` environment variable and run:
+
+```powershell
+uv publish
+```

mirror_earth_mcp-0.2.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mirror-earth-mcp"
+version = "0.2.0"
+description = "Model Context Protocol server for Mirror Earth weather data."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Mirror Earth" }]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Internet",
+]
+keywords = ["mcp", "weather", "mirror-earth"]
+
+[project.scripts]
+mirror-earth-mcp = "mirror_earth_mcp.server:main"
+
+[project.urls]
+Homepage = "https://gitee.com/gfyml/mirror-earth-mcp"
+Repository = "https://gitee.com/gfyml/mirror-earth-mcp.git"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mirror_earth_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/tests", "/README.md", "/pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = ["pytest>=7.4"]

mirror_earth_mcp-0.2.0/src/mirror_earth_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Mirror Earth MCP server package."""
+
+__version__ = "0.2.0"

mirror_earth_mcp-0.2.0/src/mirror_earth_mcp/__main__.py

@@ -0,0 +1,5 @@
+from .server import main
+
+
+if __name__ == "__main__":
+    main()

mirror_earth_mcp-0.2.0/src/mirror_earth_mcp/references/archive-forecast-api.md

@@ -0,0 +1,167 @@
+---
+title: 历史预报数据API
+description: 历史预报数据，提供过去每一次预报产生的数据。由于数据量巨大，历史预报仅对部分数据源开放，详见数据源总览。
+---
+
+以获取gfs2025年5月15日0时预报为例，这个请求是获取未来48小时逐小时气温和逐日最高气温
+请求示例：
+
+`https://api.mirror-earth.com/v1/archive-forecast?latitude=32&longitude=118&hourly=temperature_2m&daily=temperature_2m_max&models=archive_gfs&start_hour=2025-12-01T00:00&timezone=auto&forecast_hours=48&apikey=`
+
+> **Note:**
+起报时间是指预报模型运行的时间，例如2025-05-15T00:00，表示gfs在这个时间点对未来的天气做了一次预报。
+**返回结果：**
+```json
+
+{
+  ...
+  "hourly_units":{"time":"iso8601","temperature_2m":"°C"},
+  "daily_units":{"time":"iso8601","temperature_2m_max":"°C"},
+  "hourly": {
+    "time": ["2022-01-01T00:00","2022-01-01T01:00", ...],
+    "temperature_2m": [1.85,4.25,5.40,6.05,6.55,7.15,7.55,7.65,7.35, ...]
+  },
+  "daily": {
+    "time": ["2022-01-01", "2022-01-02", ...],
+    "temperature_2m_max": [7.2, 6.5, 4.3, ...]
+  }
+}
+```
+- hourly_units: 逐小时要素单位
+- daily_units: 逐日要素单位
+- hourly: 逐小时数据列表
+- daily: 逐日数据列表
+
+> **Note:**
+不同模型的数据开始时间不同，有些数据源包含起报时刻，有些不包含，为了一致性，接口将其统一从起报时刻开始返回，缺失值用nan表示。
+## 历史预报数据源总览
+
+| 模型名称    | 来源                     | 空间分辨率 | 更新频率 | 预测时长 | 可用时间范围 |
+| ----------- | ------------------------ | ---------- | -------- | -------- | ---- |
+| archive_ifs | 欧洲中期天气预报中心     | 25km       | 世界时00/06/12/18更新  | 0-360小时 | 2023-01-01至今 |
+| archive_hres | 欧洲中期天气预报中心     | 9km       | 世界时00/06/12/18更新  | 0-360小时 | 2019-01-01至今 |
+| archive_gfs | 美国国家海洋和大气管理局 | 25km       | 世界时00/06/12/18更新  | 0-384小时 | 2023-07-01至今 |
+| archive_aifs | 欧洲中期天气预报中心（AI预报模型） | 25km | 每6小时 | 0-360小时 | 2025-09-19至今 |
+| archive_graphcast | 美国国家海洋和大气管理局（AI预报模型） | 25km | 每6小时 | 0-384小时 | 2025-09-19至今 |
+| archive_cma | 中国气象局 | 12.5km | 每6小时 | 0-108小时 | 2025-09-19至今 |
+| archive_gem | 加拿大气象局 | 15km | 每12小时 | 0-240小时 | 2025-09-19至今 |
+| archive_icon | 德国气象局 | 11km | 每6小时 | 0-168小时 | 2025-09-19至今 |
+| archive_jma | 日本气象厅 | 50km | 每6小时 | 0-264小时 | 2025-09-19至今 |
+| archive_kma | 韩国气象厅 | 12km | 每6小时 | 0-288小时 | 2025-09-19至今 |
+| archive_mfa | 法国气象局 | 25km | 每6小时 | 0-96小时 | 2025-09-19至今 |
+| archive_ukmo | 英国气象局 | 10km | 每6小时 | 0-168小时 | 2025-09-19至今 |
+
+## 逐小时要素总览
+
+这里列出了部分支持的逐小时变量，每个数据源提供的有些许差异，请到数据源详情查找，缺省值用null表示
+
+### 地面要素
+
+| 名称 | 单位 | 说明 |
+|------|------|------|
+| **温度类** | | |
+| temperature_2m | °C | 2米气温 |
+| apparent_temperature | °C | 体感温度 |
+| wet_bulb_temperature_2m | °C | 2米湿球温度 |
+| dew_point_2m | °C | 2米露点温度 |
+| skin_temperature | °C | 地表温度 |
+| surface_temperature | °C | 地表温度 |
+| freezing_level_height | m | 冻结层高度，0度层高度 |
+| **湿度类** | | |
+| relative_humidity_2m | % | 2米相对湿度 |
+| vapour_pressure_deficit | hPa | 饱和水汽压差 |
+| total_column_integrated_water_vapour | kg/m² | 整层水汽含量 |
+| **风类** | | |
+| wind_speed_10m | m/s | 10米风速 |
+| wind_speed_100m | m/s | 100米风速 |
+| wind_direction_10m | ° | 10米风向 |
+| wind_direction_100m | ° | 100米风向 |
+| wind_gusts_10m | m/s | 10米阵风 |
+| updraft | m/s | 上升气流 |
+| **降水/积雪类** | | |
+| precipitation | mm | 降水量 |
+| precipitation_probability | % | 降水概率 |
+| precipitation_type | - | 降水类型 |
+| rain | mm | 降雨量 |
+| rain_probability | % | 降雨概率 |
+| showers | mm | 阵雨量 |
+| snowfall | cm | 降雪量 |
+| snowfall_probability | % | 降雪概率 |
+| snowfall_water_equivalent | mm | 降雪水当量 |
+| snowfall_height | m | 降雪高度 |
+| hail | mm | 冰雹量 |
+| freezing_rain_probability | % | 冻雨概率 |
+| ice_pellets_probability | % | 冰粒概率 |
+| snow_depth | m | 积雪深度 |
+| snow_depth_water_equivalent | mm | 积雪水当量 |
+| **云类** | | |
+| cloud_cover | % | 总云量 |
+| cloud_cover_high | % | 高云量 |
+| cloud_cover_low | % | 低云量 |
+| cloud_cover_mid | % | 中云量 |
+| cloud_cover_2m | % | 2米云量 |
+| cloud_base | m | 云底高度 |
+| cloud_top | m | 云顶高度 |
+| convective_cloud_base | m | 对流云底高度 |
+| convective_cloud_top | m | 对流云顶高度 |
+| **辐射类** | | |
+| shortwave_radiation | W/m² | 短波辐射 |
+| shortwave_radiation_clear_sky | W/m² | 晴天短波辐射 |
+| direct_radiation | W/m² | 直接辐射 |
+| direct_normal_irradiance | W/m² | 直接法线辐照度 |
+| diffuse_radiation | W/m² | 散射辐射 |
+| diffuse_radiation_instant | W/m² | 瞬时散射辐射 |
+| global_tilted_irradiance | W/m² | 倾斜辐照度 |
+| terrestrial_radiation | W/m² | 地球辐射 |
+| longwave_radiation_downward | W/m² | 向下长波辐射 |
+| shortwave_radiation_upward | W/m² | 向上短波辐射 |
+| longwave_radiation_upward | W/m² | 向上长波辐射 |
+| **土壤类** | | |
+| soil_moisture_0_to_7cm | m³/m³ | 0-7厘米土壤湿度 |
+| soil_moisture_7_to_28cm | m³/m³ | 7-28厘米土壤湿度 |
+| soil_moisture_28_to_100cm | m³/m³ | 28-100厘米土壤湿度 |
+| soil_moisture_100_to_255cm | m³/m³ | 100-255厘米土壤湿度 |
+| soil_temperature_0_to_7cm | °C | 0-7厘米土壤温度 |
+| soil_temperature_7_to_28cm | °C | 7-28厘米土壤温度 |
+| soil_temperature_28_to_100cm | °C | 28-100厘米土壤温度 |
+| soil_temperature_100_to_200cm | °C | 100-200厘米土壤温度 |
+| **气压类** | | |
+| pressure_msl | hPa | 海平面气压 |
+| surface_pressure | hPa | 地表气压 |
+| surface_air_pressure | hPa | 地表气压 |
+| pressure_80m | hPa | 80米气压 |
+| **对流/大气稳定度类** | | |
+| cape | J/kg | 对流有效位能 |
+| convective_inhibition | J/kg | 对流抑制 |
+| lifted_index | °C | 抬升指数 |
+| lightning_potential | - | 闪电潜势 |
+| thunderstorm_probability | % | 雷暴概率 |
+| **其他要素** | | |
+| sunshine_duration | s | 日照时长 |
+| uv_index | - | 紫外线指数 |
+| uv_index_clear_sky | - | 晴天紫外线指数 |
+| visibility | m | 能见度 |
+| boundary_layer_height | m | 边界层高度 |
+| albedo | - | 反照率 |
+| et0_fao_evapotranspiration | mm | FAO参考作物蒸散发 |
+| evapotranspiration | mm | 蒸散发 |
+| runoff | mm | 径流 |
+| latent_heat_flux | W/m² | 潜热通量 |
+| sensible_heat_flux | W/m² | 感热通量 |
+
+### 等压面要素
+
+| 名称 | 单位 | 说明 |
+|------|------|------|
+| temperature | °C | 温度 |
+| geopotential_height | m | 位势高度 |
+| relative_humidity | % | 相对湿度 |
+| wind_speed | m/s | 风速 |
+| wind_direction | ° | 风向 |
+| dew_point | °C | 露点温度 |
+| cloudcover | % | 云量 |
+| cloud_cover | % | 云量 |
+| vertical_velocity | m/s | 垂直速度 |
+
+需要与等压面结合起来调用，比如`temperature_1000hPa`表示1000百帕的温度，常用的等压面有：1000hPa,925hPa,850hPa,500hPa,200hPa
+

mirror_earth_mcp-0.2.0/src/mirror_earth_mcp/references/archive-forecast-models/archive_aifs.md

@@ -0,0 +1,60 @@
+---
+title: 欧洲中期天气预报中心历史预报 (archive_aifs)
+description: ECMWF AIFS 历史预报数据，25km分辨率
+---
+
+## 基本信息
+
+| 项目 | 详情 |
+|------|------|
+| **数据源名称** | archive_aifs |
+| **来源** | 欧洲中期天气预报中心（AI 预报模型） |
+| **分辨率** | 25km |
+| **时间分辨率** | 6小时 |
+| **更新频率** | 每6小时 |
+| **预报时长** | 每次0-360小时 |
+| **数据覆盖** | 全球 |
+| **可用时间范围** | 2025-09-19至今 |
+
+## 使用示例
+
+请求示例：
+
+`https://api.mirror-earth.com/v1/archive-forecast?latitude=32.0&longitude=118.0&hourly=temperature_2m&models=archive_aifs&start_hour=2025-12-01T00:00&forecast_hours=48&timezone=auto&apikey=`
+
+
+## 支持的要素
+
+### 地面要素
+
+| 名称 | 单位 | 说明 |
+|------|------|------|
+| **温度类** | | |
+| temperature_2m | °C | 2米气温 |
+| surface_temperature | °C | 地表温度 |
+| **湿度类** | | |
+| relative_humidity_2m | % | 2米相对湿度 |
+| **风类** | | |
+| wind_speed_10m | m/s | 10米风速 |
+| wind_direction_10m | ° | 10米风向 |
+| wind_speed_100m | m/s | 100米风速 |
+| wind_direction_100m | ° | 100米风向 |
+| **降水/积雪类** | | |
+| precipitation | mm | 降水量 |
+| rain | mm | 降雨量 |
+| showers | mm | 阵雨量 |
+| snowfall | cm | 降雪量 |
+| **云类** | | |
+| cloud_cover | % | 总云量 |
+| cloud_cover_low | % | 低云量 |
+| cloud_cover_mid | % | 中云量 |
+| cloud_cover_high | % | 高云量 |
+| **辐射类** | | |
+| shortwave_radiation | W/m² | 短波辐射 |
+| **气压类** | | |
+| pressure_msl | hPa | 海平面气压 |
+| **土壤类** | | |
+| soil_temperature_0_to_7cm | °C | 0-7厘米土壤温度 |
+| soil_temperature_7_to_28cm | °C | 7-28厘米土壤温度 |
+| soil_moisture_0_to_7cm | m³/m³ | 0-7厘米土壤湿度 |
+| soil_moisture_7_to_28cm | m³/m³ | 7-28厘米土壤湿度 |

mirror_earth_mcp-0.2.0/src/mirror_earth_mcp/references/archive-forecast-models/archive_cma.md

@@ -0,0 +1,119 @@
+---
+title: 中国气象局历史预报 (archive_cma)
+description: CMA 历史预报数据，12.5km分辨率
+---
+
+## 基本信息
+
+| 项目 | 详情 |
+|------|------|
+| **数据源名称** | archive_cma |
+| **来源** | 中国气象局 |
+| **分辨率** | 12.5km |
+| **时间分辨率** | 3小时 |
+| **更新频率** | 每6小时 |
+| **预报时长** | 每次0-108小时 |
+| **数据覆盖** | 全球 |
+| **可用时间范围** | 2025-09-19至今 |
+
+## 使用示例
+
+请求示例：
+
+`https://api.mirror-earth.com/v1/archive-forecast?latitude=32.0&longitude=118.0&hourly=temperature_2m&models=archive_cma&start_hour=2025-12-01T00:00&forecast_hours=48&timezone=auto&apikey=`
+
+## 支持的要素
+
+### 地面要素
+
+| 名称 | 单位 | 说明 |
+|------|------|------|
+| **温度类** | | |
+| temperature_2m | °C | 2米气温 |
+| apparent_temperature | °C | 体感温度 |
+| wet_bulb_temperature_2m | °C | 2米湿球温度 |
+| dew_point_2m | °C | 2米露点温度 |
+| surface_temperature | °C | 地表温度 |
+| **气压/湿度类** | | |
+| pressure_msl | hPa | 海平面气压 |
+| surface_pressure | hPa | 地表气压 |
+| relative_humidity_2m | % | 2米相对湿度 |
+| vapour_pressure_deficit | hPa | 饱和水汽压差 |
+| **风类** | | |
+| wind_speed_10m | m/s | 10米风速 |
+| wind_direction_10m | ° | 10米风向 |
+| wind_speed_30m | m/s | 30米风速 |
+| wind_direction_30m | ° | 30米风向 |
+| wind_speed_50m | m/s | 50米风速 |
+| wind_direction_50m | ° | 50米风向 |
+| wind_speed_70m | m/s | 70米风速 |
+| wind_direction_70m | ° | 70米风向 |
+| wind_speed_100m | m/s | 100米风速 |
+| wind_direction_100m | ° | 100米风向 |
+| wind_speed_120m | m/s | 120米风速 |
+| wind_direction_120m | ° | 120米风向 |
+| wind_speed_140m | m/s | 140米风速 |
+| wind_direction_140m | ° | 140米风向 |
+| wind_speed_160m | m/s | 160米风速 |
+| wind_direction_160m | ° | 160米风向 |
+| wind_speed_180m | m/s | 180米风速 |
+| wind_direction_180m | ° | 180米风向 |
+| wind_speed_200m | m/s | 200米风速 |
+| wind_direction_200m | ° | 200米风向 |
+| wind_gusts_10m | m/s | 10米阵风 |
+| **降水/积雪类** | | |
+| precipitation | mm | 降水量 |
+| precipitation_type | - | 降水类型 |
+| showers | mm | 阵雨量 |
+| snowfall | cm | 降雪量 |
+| snow_depth | m | 积雪深度 |
+| rain | mm | 降雨量 |
+| **对流/大气稳定度类** | | |
+| cape | J/kg | 对流有效位能 |
+| convective_inhibition | J/kg | 对流抑制 |
+| lifted_index | °C | 抬升指数 |
+| **辐射/能量类** | | |
+| sunshine_duration | s | 日照时长 |
+| shortwave_radiation | W/m² | 短波辐射 |
+| shortwave_radiation_clear_sky | W/m² | 晴天短波辐射 |
+| direct_radiation | W/m² | 直接辐射 |
+| direct_normal_irradiance | W/m² | 直接法线辐照度 |
+| diffuse_radiation | W/m² | 散射辐射 |
+| diffuse_radiation_instant | W/m² | 瞬时散射辐射 |
+| global_tilted_irradiance | W/m² | 倾斜辐照度 |
+| terrestrial_radiation | W/m² | 地球辐射 |
+| terrestrial_radiation_instant | W/m² | 地球瞬时辐射 |
+| **土壤类** | | |
+| soil_temperature_0_to_10cm | °C | 0-10厘米土壤温度 |
+| soil_temperature_10_to_40cm | °C | 10-40厘米土壤温度 |
+| soil_temperature_40_to_100cm | °C | 40-100厘米土壤温度 |
+| soil_temperature_100_to_200cm | °C | 100-200厘米土壤温度 |
+| soil_moisture_0_to_10cm | m³/m³ | 0-10厘米土壤湿度 |
+| soil_moisture_10_to_40cm | m³/m³ | 10-40厘米土壤湿度 |
+| soil_moisture_40_to_100cm | m³/m³ | 40-100厘米土壤湿度 |
+| soil_moisture_100_to_200cm | m³/m³ | 100-200厘米土壤湿度 |
+| **其它** | | |
+| visibility | m | 能见度 |
+| weather_id | - | 天气代码 |
+| is_day | - | 是否白天 |
+| et0_fao_evapotranspiration | mm | FAO参考作物蒸散发 |
+
+---
+
+### 等压面要素
+
+| 名称 | 单位 | 说明 |
+|------|------|------|
+| temperature | °C | 温度 |
+| geopotential_height | m | 位势高度 |
+| relative_humidity | % | 相对湿度 |
+| wind_speed | m/s | 风速 |
+| wind_direction | ° | 风向 |
+| dew_point | °C | 露点温度 |
+| cloud_cover | % | 云量 |
+| vertical_velocity | m/s | 垂直速度 |
+
+**等压面**
+1000 hPa、975 hPa、950 hPa、925 hPa、900 hPa、850 hPa、800 hPa、775 hPa、750 hPa、700 hPa、650 hPa、600 hPa、550 hPa、500 hPa、450 hPa、400 hPa、350 hPa、300 hPa、275 hPa、250 hPa、225 hPa、200 hPa、175 hPa、150 hPa、125 hPa、100 hPa、70 hPa、50 hPa、30 hPa、20 hPa、10 hPa  
+
+> 注：等压面变量需与具体气压层（如 temperature_850hPa）结合使用。

mirror_earth_mcp-0.2.0/src/mirror_earth_mcp/references/archive-forecast-models/archive_gem.md

@@ -0,0 +1,109 @@
+---
+title: 加拿大气象局历史预报 (archive_gem)
+description: GEM 历史预报数据，15km分辨率
+---
+
+## 基本信息
+
+| 项目 | 详情 |
+|------|------|
+| **数据源名称** | archive_gem |
+| **来源** | 加拿大气象局 |
+| **分辨率** | 15km |
+| **时间分辨率** | 3小时 |
+| **更新频率** | 每12小时 |
+| **预报时长** | 每次0-240小时 |
+| **数据覆盖** | 全球 |
+| **可用时间范围** | 2025-09-19至今 |
+
+## 使用示例
+
+请求示例：
+
+`https://api.mirror-earth.com/v1/archive-forecast?latitude=32.0&longitude=118.0&hourly=temperature_2m&models=archive_gem&start_hour=2025-12-01T00:00&forecast_hours=48&timezone=auto&apikey=`
+
+
+## 支持的要素
+
+### 地面要素
+
+| 名称 | 单位 | 说明 |
+|------|------|------|
+| **温度类** | | |
+| temperature_2m | °C | 2米气温 |
+| temperature_40m | °C | 40米气温 |
+| temperature_80m | °C | 80米气温 |
+| temperature_120m | °C | 120米气温 |
+| apparent_temperature | °C | 体感温度 |
+| dew_point_2m | °C | 2米露点温度 |
+| wet_bulb_temperature_2m | °C | 2米湿球温度 |
+| **湿度类** | | |
+| relative_humidity_2m | % | 2米相对湿度 |
+| vapour_pressure_deficit | hPa | 饱和水汽压差 |
+| **风类** | | |
+| wind_speed_10m | m/s | 10米风速 |
+| wind_direction_10m | ° | 10米风向 |
+| wind_speed_40m | m/s | 40米风速 |
+| wind_direction_40m | ° | 40米风向 |
+| wind_speed_80m | m/s | 80米风速 |
+| wind_direction_80m | ° | 80米风向 |
+| wind_speed_120m | m/s | 120米风速 |
+| wind_direction_120m | ° | 120米风向 |
+| wind_gusts_10m | m/s | 10米阵风 |
+| **降水/积雪类** | | |
+| precipitation | mm | 降水量 |
+| showers | mm | 阵雨量 |
+| snowfall | cm | 降雪量 |
+| snowfall_water_equivalent | mm | 降雪水当量 |
+| snow_depth | m | 积雪深度 |
+| rain | mm | 降雨量 |
+| **云类** | | |
+| cloud_cover | % | 总云量 |
+| cloud_cover_low | % | 低云量 |
+| cloud_cover_mid | % | 中云量 |
+| cloud_cover_high | % | 高云量 |
+| **辐射类** | | |
+| shortwave_radiation | W/m² | 短波辐射 |
+| shortwave_radiation_instant | W/m² | 瞬时短波辐射 |
+| direct_radiation | W/m² | 直接辐射 |
+| direct_radiation_instant | W/m² | 瞬时直接辐射 |
+| direct_normal_irradiance | W/m² | 直接法线辐照度 |
+| direct_normal_irradiance_instant | W/m² | 瞬时直接法线辐照度 |
+| diffuse_radiation | W/m² | 散射辐射 |
+| diffuse_radiation_instant | W/m² | 瞬时散射辐射 |
+| global_tilted_irradiance | W/m² | 倾斜辐照度 |
+| global_tilted_irradiance_instant | W/m² | 瞬时倾斜辐照度 |
+| terrestrial_radiation | W/m² | 地球辐射 |
+| terrestrial_radiation_instant | W/m² | 地球瞬时辐射 |
+| **气压类** | | |
+| pressure_msl | hPa | 海平面气压 |
+| surface_pressure | hPa | 地表气压 |
+| **土壤类** | | |
+| soil_temperature_0_to_10cm | °C | 0-10厘米土壤温度 |
+| soil_moisture_0_to_10cm | m³/m³ | 0-10厘米土壤湿度 |
+| **对流/大气稳定度类** | | |
+| cape | J/kg | 对流有效位能 |
+| **其他要素** | | |
+| weather_id | - | 天气代码 |
+| is_day | - | 是否白天 |
+| sunshine_duration | s | 日照时长 |
+| et0_fao_evapotranspiration | mm | FAO参考作物蒸散发 |
+| visibility | m | 能见度 |
+
+---
+
+### 等压面要素
+
+支持以下等压面（1015, 1000, 985, 970, 950, 925, 900, 875, 850, 800, 750, 700, 650, 600, 550, 500, 450, 400, 350, 300, 275, 250, 225, 200, 175, 150, 100, 50, 30, 20, 10 hPa）：
+
+| 名称 | 单位 | 说明 |
+|------|------|------|
+| temperature | °C | 温度 |
+| dew_point | °C | 露点温度 |
+| relative_humidity | % | 相对湿度 |
+| wind_speed | m/s | 风速 |
+| wind_direction | ° | 风向 |
+| geopotential_height | m | 位势高度 |
+| cloud_cover | % | 云量 |
+
+> 注：等压面变量需与具体气压层（如 temperature_850hPa）结合使用。