Weather My MCP

🚀 天氣 MCP 服務器

本項目是一個基本的 Model Context Protocol (MCP) 服務器，可從馬來西亞官方開放數據門戶 Open API 獲取天氣信息。藉助該服務器，LLM 能夠獲取天氣預報、警告、與洪水相關的水位以及地震報告等內容，為相關應用提供有力的數據支持。

API 文檔：data.gov.my

🚀 快速開始

Claude Desktop 配置

將以下內容添加到 claude_desktop_config.json 文件中。有關更多詳細信息，請參閱 針對 Claude Desktop 用戶。

使用 uv

{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "weather-my-mcp",
                "run",
                "weather.py"
            ]
        }
    }
}

使用 Docker

1. 創建 docker 鏡像

docker build . --tag weather-my-mcp

2. 編輯 claude_desktop_config.json 文件如下：

{
    "mcpServers": {
        "weather": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "weather-my-mcp"
            ]
        }
    }
}

✨ 主要特性

本服務器能夠提供從馬來西亞官方開放數據門戶 Open API 獲取的天氣信息，支持 LLM 獲取天氣預報、警告、與洪水相關的水位和地震報告等。

📚 詳細文檔

組件 - 工具

1. get_water_level_condition

• 功能：獲取指定縣或州關聯的洪水警告相關的水位條件。若同時提供了縣和州，則優先使用縣；若未指定縣或州，請在相應字段中使用空字符串。
• 參數：
  • district：要檢索洪水警告條件的縣的名稱。
  • state：要檢索洪水警告條件的州的名稱。

2. get_warning

• 功能：在指定日期範圍內獲取天氣警告信息。
• 參數：
  • datetime_start：最早的時間戳，格式為 YYYY-MM-DD HH:MM:SS（包含在內），從該時間開始檢索天氣警告。如果未提供，默認為當前日期。
  • datetime_end：最晚的時間戳，格式為 YYYY-MM-DD HH:MM:SS（包含在內），到此時間停止檢索天氣警告。如果未提供，默認為當前日期。

3. get_weather_forecast

• 功能：根據指定的日期範圍獲取特定位置的天氣預報。
• 參數：
  • location_name：獲取預報的位置的名稱或標識符。
  • date_start：最早的日期（包含在內）開始檢索天氣預報。如果未提供，默認為當前日期。
  • date_end：最晚的日期（包含在內）停止檢索天氣預報。如果未提供，默認為當前日期。

4. get_earthquake_news

• 功能：根據指定位置和日期範圍獲取地震新聞。
• 參數：
  • location：地震發生地的名稱或標識符。
  • date_start：最早的日期（包含在內）開始搜索地震新聞。如果未提供，默認為當前日期。
  • date_end：最晚的日期（包含在內）停止搜索地震新聞。如果未提供，默認為當前日期。

📄 許可證

此 MCP 服務器根據 MIT License 分發。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT License 的條款和條件。有關更多詳細信息，請參閱項目存儲庫中的 LICENSE 文件。