What is Weather My Mcp

weather-my-mcp is a Model Context Protocol (MCP) server that provides weather information sourced from the Open API of Malaysia’s official open data portal. It enables users to access weather forecasts, warnings, flood-related water levels, and earthquake reports.

Use cases

Use cases for weather-my-mcp include: 1) Monitoring flood risks by retrieving water level conditions, 2) Issuing timely weather warnings to the public, 3) Providing accurate weather forecasts for event planning and agricultural activities.

How to use

To use weather-my-mcp, you can access its API endpoints to retrieve specific weather data. You can query for water level conditions, general weather warnings, and weather forecasts by providing the necessary parameters such as location, date range, and district or state.

Key features

Key features of weather-my-mcp include: 1) Retrieval of water level conditions related to flood warnings, 2) Access to general weather warnings within a specified date range, 3) Provision of weather forecasts for specific locations over a defined period.

Where to use

weather-my-mcp can be used in various fields including disaster management, environmental monitoring, and any application requiring real-time weather data for decision-making.

Weather MCP Server

A basic Model Context Protocol (MCP) server that provides weather information retrieved from Open API of Malaysia’s official open data portal. This server enables LLMs to get weather forecast, warnings, water level associated with flood, and earthquake reports.

API Documentation: data.gov.my

Components

Tools

1. get_water_level_condition

   • Retrieve the water level conditions associated with flood warnings for a specified district or state.
     If both district and state are provided, the district takes precedence.
     If district or state is not specified, use an empty string for that field.

   • Args:

     • district: The name of the district within the specified state for which to retrieve flood warning conditions.
     • state: The name of the state in Malaysia for which to retrieve flood warning conditions.

2. get_warning

   • Retrieve general weather warnings issued within a specified date range.

   • Args:

     • datetime_start: The earliest timestamp in the form of YYYY-MM-DD HH:MM:SS (inclusive) from which to retrieve weather warnings. If omitted, defaults to the current date.
     • datetime_end: The latest timestamp in the form of YYYY-MM-DD HH:MM:SS (inclusive) to stop retrieving the weather warnings. If omitted, defaults to the current date.

3. get_weather_forecast

   • Retrieve a weather forecast for a specific location within a given date range.

   • Args:

     • location_name: The name or identifier of the location for which the forecast is retrieved.
     • date_start: The earliest date (inclusive) to begin retrieving the weather forecast. If omitted, defaults to the current date.
     • date_end: The latest date (inclusive) to stop retrieving the weather forecast. If omitted, defaults to the current date.

4. get_earthquake_news

   • Fetch earthquake news for a given location within a specified date range.

   • Args:

     • location: Name or identifier of the place where the earthquake(s) occurred.
     • date_start: The earliest date (inclusive) to start searching for earthquake news. If omitted, defaults to the current date.
     • date_end: The latest date (inclusive) to stop searching for earthquake news. If omitted, defaults to the current date.

Claude Desktop configuration

Add the following into claude_desktop_config.json file. For more information, refer to For Claude Desktop Users.

Using uv

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

Using Docker

1. Create docker image

   docker build . --tag weather-my-mcp
   

2. Edit claude_desktop_config.json file as follows:

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

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.