Weather MCP Server

Weather MCP Server

一个基础的 Model Context Protocol（MCP）服务，可从马来西亚官方开放数据门户的 Open API 获取天气信息。此服务可让大模型获取天气预报、警报、与洪水相关的水位信息以及地震报告。

API 文档：data.gov.my

组件

工具

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：停止搜索地震新闻的最晚日期（含）。如果省略，默认为当前日期。

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"
               ]
           }
       }
   }
   

许可证

此 MCP 服务采用 MIT License 许可。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。