hkopenai.hk-climate-mcp-server 0.2.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

{hkopenai_hk_climate_mcp_server-0.2.0.dist-info → hkopenai_hk_climate_mcp_server-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hkopenai.hk_climate_mcp_server
-Version: 0.2.0
+Version: 0.4.0
 Summary: Hong Kong Weather MCP Server providing climate and weather data tools
 Author-email: Neo Chow <neo@01man.com>
 License-Expression: MIT
@@ -16,7 +16,7 @@ Requires-Dist: pytest>=8.2.0
 Requires-Dist: pytest-cov>=6.1.1
 Dynamic: license-file
 
-# HKO MCP Server
+# HK Climate and Weather MCP Server
 
 [![GitHub Repository](https://img.shields.io/badge/GitHub-Repository-blue.svg)](https://github.com/hkopenai/hk-climate-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -106,6 +106,77 @@ This is an MCP server that provides access to climate and weather data through a
     - specialWeatherTips: List of special weather tips
     - updateTime: Last update time
 
+### Visibility Data
+`get_visibility_data(lang: str = "en") -> Dict`
+- Get latest 10-minute mean visibility data for Hong Kong
+- Parameters:
+  - lang: Language code (en/tc/sc, default: en)
+- Returns:
+  - Dict containing visibility data with fields and data arrays
+
+### Lightning Data  
+`get_lightning_data(lang: str = "en") -> Dict`
+- Get cloud-to-ground and cloud-to-cloud lightning count data
+- Parameters:
+  - lang: Language code (en/tc/sc, default: en)
+- Returns:
+  - Dict containing lightning data with fields and data arrays
+
+### Moon Times
+`get_moon_times(year: int, month: Optional[int] = None, day: Optional[int] = None, lang: str = "en") -> Dict`
+- Get times of moonrise, moon transit and moonset
+- Parameters:
+  - year: Year (2018-2024)
+  - month: Optional month (1-12)
+  - day: Optional day (1-31)
+  - lang: Language code (en/tc/sc, default: en)
+- Returns:
+  - Dict containing moon times data with fields and data arrays
+
+### Hourly Tides
+`get_hourly_tides(station: str, year: int, month: Optional[int] = None, day: Optional[int] = None, hour: Optional[int] = None, lang: str = "en") -> Dict`
+- Get hourly heights of astronomical tides for a specific station
+- Parameters:
+  - station: Station code (e.g. 'CCH' for Cheung Chau)
+  - year: Year (2022-2024)
+  - month: Optional month (1-12)
+  - day: Optional day (1-31)
+  - hour: Optional hour (1-24)
+  - lang: Language code (en/tc/sc, default: en)
+- Returns:
+  - Dict containing tide data with fields and data arrays
+
+### High/Low Tides
+`get_high_low_tides(station: str, year: int, month: Optional[int] = None, day: Optional[int] = None, hour: Optional[int] = None, lang: str = "en") -> Dict`
+- Get times and heights of astronomical high and low tides
+- Parameters:
+  - station: Station code (e.g. 'CCH' for Cheung Chau)
+  - year: Year (2022-2024)
+  - month: Optional month (1-12)
+  - day: Optional day (1-31)
+  - hour: Optional hour (1-24)
+  - lang: Language code (en/tc/sc, default: en)
+- Returns:
+  - Dict containing tide data with fields and data arrays
+
+### Weather and Radiation Report
+`get_weather_radiation_report(date: str, station: str, lang: str = "en") -> Dict`
+- Get weather and radiation level report for Hong Kong
+- Parameters:
+  - date: Mandatory date in YYYYMMDD format (e.g., 20250618)
+  - station: Mandatory station code (e.g., 'HKO' for Hong Kong Observatory)
+  - lang: Language code (en/tc/sc, default: en)
+- Returns:
+  - Dict containing weather and radiation data or error message if parameters are invalid
+
+### Station Codes
+`get_radiation_station_codes() -> Dict`
+- Get a list of station codes and their corresponding names for weather and radiation reports in Hong Kong
+- Parameters:
+  - None
+- Returns:
+  - Dict mapping station codes to station names
+
 ## Setup
 
 1. Clone this repository
@@ -115,13 +186,13 @@ This is an MCP server that provides access to climate and weather data through a
    ```
 3. Run the server:
    ```bash
-   python app.py
+   python server.py
    ```
 
 ### Running Options
 
-- Default stdio mode: `python app.py`
-- SSE mode (port 8000): `python app.py --sse`
+- Default stdio mode: `python server.py`
+- SSE mode (port 8000): `python server.py --sse`
 
 ## Cline Integration
 
@@ -136,7 +207,8 @@ To connect this MCP server to Cline using stdio:
     "type": "stdio",
     "command": "python",
     "args": [
-      "c:/Projects/hkopenai/hk-climate-mcp-server/app.py"
+      "-m",
+      "hkopenai.hk_climate_mcp_server"
     ]
   }
 }

hkopenai_hk_climate_mcp_server-0.4.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+hkopenai/hk_climate_mcp_server/__init__.py,sha256=DDVTAriSgigX8xSy17OE0w3Wv05yuiD4EdJixt6eNLw,112
+hkopenai/hk_climate_mcp_server/__main__.py,sha256=bIsnXlqwCtkerzB-j-IVGQR1zFNgZmeFxi3ww3AXe3Q,94
+hkopenai/hk_climate_mcp_server/server.py,sha256=ftkqYWopE2EgKLEG4JjPyKl4Okhhy2hBauCu6hzJI3I,8307
+hkopenai/hk_climate_mcp_server/tools/astronomical.py,sha256=hkrXihSdNfaY14kY9ePQsbiAfO8tQzONjkLfJUgk5CA,2990
+hkopenai/hk_climate_mcp_server/tools/current_weather.py,sha256=iywirobmBHPAK2b3u9UChQSafuIcpoFPTUorRSbpAS4,3613
+hkopenai/hk_climate_mcp_server/tools/forecast.py,sha256=wwxM5SSbZ_zFBkY2kbp2ehWd7c_hD6spAsz3aYHZmUw,3035
+hkopenai/hk_climate_mcp_server/tools/lightning.py,sha256=eSiObmsMuKKakJT1fkg7e0B_Bwie0hSV_9ggegm497U,671
+hkopenai/hk_climate_mcp_server/tools/radiation.py,sha256=EkCqKPpJVrOusm2BoQrfP1onq6Sl9XSSP0rnKcQRZjg,6529
+hkopenai/hk_climate_mcp_server/tools/temperature.py,sha256=FiHCnq7OBsUNrpbDTKEfK3HyO6euKJ5Io9bciYhe2XM,3809
+hkopenai/hk_climate_mcp_server/tools/tides.py,sha256=qpiYkulyEnnKzXZiZLIPtk2wDn3uKs_UpKyb8XXO23I,5089
+hkopenai/hk_climate_mcp_server/tools/visibility.py,sha256=CHfLcuH6HKix6_7395ado-VppNFPlTYHABLtdXmIzV4,668
+hkopenai/hk_climate_mcp_server/tools/warnings.py,sha256=XjJW25CjiAuJTmzssLDkp4oNcCIke4vbOYTaVH93EOc,2446
+hkopenai_hk_climate_mcp_server-0.4.0.dist-info/licenses/LICENSE,sha256=RzryYGol65qd1yszjiy-hSUsX9EJJkpwEpNXnIs_Bv8,1070
+hkopenai_hk_climate_mcp_server-0.4.0.dist-info/METADATA,sha256=pBkI1stOW_CC-YERrc8lFpsVvyWdqAw6jTUg35M0g4o,7173
+hkopenai_hk_climate_mcp_server-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hkopenai_hk_climate_mcp_server-0.4.0.dist-info/entry_points.txt,sha256=2pPEyDw5KdrNNZIGQsSrY-5IRMgWaWvEQT_BQJhKPMQ,82
+hkopenai_hk_climate_mcp_server-0.4.0.dist-info/top_level.txt,sha256=6PRVKRM9BiU5vzKKGnsq2t0-Bi0TrJvSY35llo4nLFA,9
+hkopenai_hk_climate_mcp_server-0.4.0.dist-info/RECORD,,

hkopenai/hk_climate_mcp_server/app.py

@@ -1,65 +0,0 @@
-import argparse
-from fastmcp import FastMCP
-from hkopenai.hk_climate_mcp_server import tool_weather
-from typing import Dict, Annotated, Optional
-from pydantic import Field
-
-def create_mcp_server():
-    """Create and configure the HKO MCP server"""
-    mcp = FastMCP(name="HKOServer")
-
-    @mcp.tool(
-        description="Get current weather observations, warnings, temperature, humidity and rainfall in Hong Kong from Hong Kong Observatory, with optional region or place in Hong Kong",
-    )
-    def get_current_weather(region: str = "Hong Kong Observatory") -> Dict:
-        return tool_weather.get_current_weather(region)
-
-    @mcp.tool(
-        description="Get the 9-day weather forecast for Hong Kong including general situation, daily forecasts, sea and soil temperatures",
-    )
-    def get_9_day_weather_forecast(lang: str = "en") -> Dict:
-        return tool_weather.get_9_day_weather_forecast(lang)
-
-    @mcp.tool(
-        description="Get local weather forecast for Hong Kong including forecast description, outlook and update time",
-    )
-    def get_local_weather_forecast(lang: str = "en") -> Dict:
-        return tool_weather.get_local_weather_forecast(lang)
-
-    @mcp.tool(
-        description="Get weather warning summary for Hong Kong including warning messages and update time",
-    )
-    def get_weather_warning_summary(lang: str = "en") -> Dict:
-        return tool_weather.get_weather_warning_summary(lang)
-
-    @mcp.tool(
-        description="Get detailed weather warning information for Hong Kong including warning statement and update time",
-    )
-    def get_weather_warning_info(lang: str = "en") -> Dict:
-        return tool_weather.get_weather_warning_info(lang)
-
-    @mcp.tool(
-        description="Get special weather tips for Hong Kong including tips list and update time",
-    )
-    def get_special_weather_tips(lang: str = "en") -> Dict:
-        return tool_weather.get_special_weather_tips(lang)
-    
-    return mcp
-
-def main():
-    parser = argparse.ArgumentParser(description='HKO MCP Server')
-    parser.add_argument('-s', '--sse', action='store_true',
-                       help='Run in SSE mode instead of stdio')
-    args = parser.parse_args()
-
-    server = create_mcp_server()
-    
-    if args.sse:
-        server.run(transport="streamable-http")
-        print("HKO MCP Server running in SSE mode on port 8000")
-    else:
-        server.run()
-        print("HKO MCP Server running in stdio mode")
-
-if __name__ == "__main__":
-    main()

hkopenai/hk_climate_mcp_server/tool_weather.py

@@ -1,241 +0,0 @@
-import requests
-from typing import Dict, List, Any
-
-def get_current_weather(region: str = "Hong Kong Observatory", lang: str = "en") -> Dict:
-    """
-    Get current weather observations for a specific region in Hong Kong
-
-    Args:
-        region: The region to get weather for (default: "Hong Kong Observatory")
-        lang: Language code (en/tc/sc, default: en)
-
-    Returns:
-        Dict containing:
-        - warning: Current weather warnings
-        - temperature: Current temperature in Celsius
-        - humidity: Current humidity percentage
-        - rainfall: Current rainfall in mm
-    """
-    response = requests.get(
-        f"https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=rhrread&lang={lang}"
-    )
-    data = response.json()
-
-    # Handle warnings
-    warning = "No warning in force"
-    if "warningMessage" in data:
-        if isinstance(data["warningMessage"], list) and data["warningMessage"]:
-            warning = data["warningMessage"][0]
-        elif data["warningMessage"]:  # Handle string case
-            warning = data["warningMessage"]
-
-    # Get default values from HKO data
-    default_temp = next(
-        (
-            t
-            for t in data.get("temperature", {}).get("data", [])
-            if t.get("place") == "Hong Kong Observatory"
-        ),
-        {"value": 25, "unit": "C", "recordTime": ""},
-    )
-    default_humidity = next(
-        (
-            h
-            for h in data.get("humidity", {}).get("data", [])
-            if h.get("place") == "Hong Kong Observatory"
-        ),
-        {"value": 60, "unit": "percent", "recordTime": ""},
-    )
-    # Find matching region temperature
-    temp_data = data.get("temperature", {}).get("data", [])
-    matched_temp = next(
-        (t for t in temp_data if t["place"].lower() == region.lower()),
-        {
-            "place": "Hong Kong Observatory",
-            "value": default_temp["value"],
-            "unit": default_temp["unit"],
-        },
-    )
-    matched_temp["recordTime"] = data["temperature"]["recordTime"]
-
-    # Get humidity
-    humidity = next(
-        (
-            h
-            for h in data.get("humidity", {}).get("data", [])
-            if h.get("place") == matched_temp["place"]
-        ),
-        default_humidity,
-    )
-    humidity["recordTime"] = data["humidity"]["recordTime"]
-
-    # Get rainfall (0 if no rain)
-    rainfall = 0
-    if "rainfall" in data:
-        rainfall = max(float(r.get("max", 0)) for r in data["rainfall"]["data"])
-        rainfall_start = data["rainfall"]["startTime"]
-        rainfall_end = data["rainfall"]["endTime"]
-
-    return {
-        "generalSituation": warning,
-        "weatherObservation": {
-            "temperature": {
-                "value": matched_temp["value"],
-                "unit": matched_temp["unit"],
-                "recordTime": matched_temp["recordTime"],
-                "place": matched_temp["place"]
-            },
-            "humidity": {
-                "value": humidity["value"],
-                "unit": humidity["unit"],
-                "recordTime": humidity["recordTime"],
-                "place": matched_temp["place"]
-            },
-            "rainfall": {
-                "value": rainfall,
-                "min": min(float(r.get("min", 0)) for r in data["rainfall"]["data"]),
-                "unit": "mm",
-                "startTime": rainfall_start,
-                "endTime": rainfall_end
-            },
-            "uvindex": data.get("uvindex", {})
-        },
-        "updateTime": data["updateTime"],
-        "icon": data.get("icon", []),
-        "iconUpdateTime": data.get("iconUpdateTime", "")
-    }
-
-def get_9_day_weather_forecast(lang: str = "en") -> Dict[str, Any]:
-    """
-    Get the 9-day weather forecast for Hong Kong.
-
-    Args:
-        lang: Language code (en/tc/sc, default: en)
-
-    Returns:
-        Dict containing:
-            - generalSituation: General weather situation
-            - weatherForecast: List of daily forecast dicts (date, week, wind, weather, temp/humidity, etc.)
-            - updateTime: Last update time
-            - seaTemp: Sea temperature info
-            - soilTemp: List of soil temperature info
-    """
-    url = f"https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=fnd&lang={lang}"
-    response = requests.get(url)
-    data = response.json()
-
-    # Structure the output
-    forecast = {
-        "generalSituation": data.get("generalSituation", ""),
-        "weatherForecast": [],
-        "updateTime": data.get("updateTime", ""),
-        "seaTemp": data.get("seaTemp", {}),
-        "soilTemp": data.get("soilTemp", []),
-    }
-
-    # Extract 9-day forecast
-    for day in data.get("weatherForecast", []):
-        forecast["weatherForecast"].append({
-            "forecastDate": day.get("forecastDate", ""),
-            "week": day.get("week", ""),
-            "forecastWind": day.get("forecastWind", ""),
-            "forecastWeather": day.get("forecastWeather", ""),
-            "forecastMaxtemp": day.get("forecastMaxtemp", {}),
-            "forecastMintemp": day.get("forecastMintemp", {}),
-            "forecastMaxrh": day.get("forecastMaxrh", {}),
-            "forecastMinrh": day.get("forecastMinrh", {}),
-            "ForecastIcon": day.get("ForecastIcon", ""),
-            "PSR": day.get("PSR", ""),
-        })
-    return forecast
-
-def get_local_weather_forecast(lang: str = "en") -> Dict[str, Any]:
-    """
-    Get local weather forecast for Hong Kong.
-
-    Args:
-        lang: Language code (en/tc/sc, default: en)
-
-    Returns:
-        Dict containing:
-            - forecastDesc: Forecast description
-            - outlook: Outlook forecast
-            - updateTime: Last update time
-            - forecastPeriod: Forecast period
-            - forecastDate: Forecast date
-    """
-    url = f"https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=flw&lang={lang}"
-    response = requests.get(url)
-    data = response.json()
-    
-    return {
-        "generalSituation": data.get("generalSituation", ""),
-        "forecastDesc": data.get("forecastDesc", ""),
-        "outlook": data.get("outlook", ""),
-        "updateTime": data.get("updateTime", ""),
-        "forecastPeriod": data.get("forecastPeriod", ""),
-        "forecastDate": data.get("forecastDate", ""),
-    }
-
-def get_weather_warning_summary(lang: str = "en") -> Dict[str, Any]:
-    """
-    Get weather warning summary for Hong Kong.
-
-    Args:
-        lang: Language code (en/tc/sc, default: en)
-
-    Returns:
-        Dict containing:
-            - warningMessage: List of warning messages
-            - updateTime: Last update time
-    """
-    url = f"https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=warnsum&lang={lang}"
-    response = requests.get(url)
-    data = response.json()
-    
-    return {
-        "warningMessage": data.get("warningMessage", []),
-        "updateTime": data.get("updateTime", ""),
-    }
-
-def get_weather_warning_info(lang: str = "en") -> Dict[str, Any]:
-    """
-    Get detailed weather warning information for Hong Kong.
-
-    Args:
-        lang: Language code (en/tc/sc, default: en)
-
-    Returns:
-        Dict containing:
-            - warningStatement: Warning statement
-            - updateTime: Last update time
-    """
-    url = f"https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=warningInfo&lang={lang}"
-    response = requests.get(url)
-    data = response.json()
-    
-    return {
-        "warningStatement": data.get("warningStatement", ""),
-        "updateTime": data.get("updateTime", ""),
-    }
-
-def get_special_weather_tips(lang: str = "en") -> Dict[str, Any]:
-    """
-    Get special weather tips for Hong Kong.
-
-    Args:
-        lang: Language code (en/tc/sc, default: en)
-
-    Returns:
-        Dict containing:
-            - specialWeatherTips: List of special weather tips
-            - updateTime: Last update time
-    """
-    url = f"https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=swt&lang={lang}"
-    response = requests.get(url)
-    data = response.json()
-    
-    return {
-        "specialWeatherTips": data.get("specialWeatherTips", []),
-        "updateTime": data.get("updateTime", ""),
-    }

hkopenai_hk_climate_mcp_server-0.2.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-hkopenai/hk_climate_mcp_server/__init__.py,sha256=QgSoOyNq_fnuED4FMOV9aj2ZDyEmezGRy2GCP427G5g,519
-hkopenai/hk_climate_mcp_server/__main__.py,sha256=2rpUSwIvU59qepKyDNMz6AtDrbsRVVIZZP0hL5LoZbs,91
-hkopenai/hk_climate_mcp_server/app.py,sha256=sTJS-eEBwyZz4KiGSEJ5QVzhiBNAGvUPAukhYNlkiEk,2479
-hkopenai/hk_climate_mcp_server/tool_weather.py,sha256=MitwPrgdE08zszoIqezY-Cxo5Z5fN5HHiZ6T-IpP3N0,8180
-hkopenai_hk_climate_mcp_server-0.2.0.dist-info/licenses/LICENSE,sha256=RzryYGol65qd1yszjiy-hSUsX9EJJkpwEpNXnIs_Bv8,1070
-hkopenai_hk_climate_mcp_server-0.2.0.dist-info/METADATA,sha256=CQb8Er_uk1Ms9ZQEKfS7l7ytdBo_K06yWrV9d6t-7zI,4415
-hkopenai_hk_climate_mcp_server-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-hkopenai_hk_climate_mcp_server-0.2.0.dist-info/entry_points.txt,sha256=2pPEyDw5KdrNNZIGQsSrY-5IRMgWaWvEQT_BQJhKPMQ,82
-hkopenai_hk_climate_mcp_server-0.2.0.dist-info/top_level.txt,sha256=6PRVKRM9BiU5vzKKGnsq2t0-Bi0TrJvSY35llo4nLFA,9
-hkopenai_hk_climate_mcp_server-0.2.0.dist-info/RECORD,,