天气 MCP 服务器

一个基础的模型上下文协议（MCP）服务器，提供从马来西亚官方开放数据门户的Open API获取的天气信息。该服务器使LLMs能够获取天气预报、警告、与洪水相关的水位信息以及地震报告。

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文件中。更多信息，请参考For Claude Desktop Users。

使用 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许可证授权。这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。更多详情，请参阅项目仓库中的LICENSE文件。