Weather

Model Context Protocol (MCP) server that provides weather information from Malaysia Government's Open API

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yting27-weather-my-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "weather-my-mcp",
        "run",
        "weather.py"
      ],
      "env": {
        "DOCKER_HOST": "unix:///var/run/docker.sock",
        "UV_DIRECTORY": "weather-my-mcp"
      }
    }
  }
}

You can access Malaysia’s official open data weather information through this Weather MCP Server. It exposes tools to get weather forecasts, warnings, flood-related water levels, and earthquake news, so you can integrate fresh meteorological data into your apps and language models easily.

How to use

Connect to the Weather MCP Server using your MCP client. You will have access to four core capabilities: get_water_level_condition to retrieve flood-related water levels for a district or state; get_warning to fetch general weather warnings within a date range; get_weather_forecast to obtain forecasts for a location over a date range; and get_earthquake_news to fetch earthquake-related news for a location over a date range. Use these tools to build timely weather dashboards, alerting flows, or context for decision-making in your applications. When you provide district and state, district takes precedence for water level lookups.

How to install

Choose a runtime method to run the MCP server. You can run it locally via Claude Desktop using UV (uv) or run it inside Docker. Both options are shown below.

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

If you choose Docker, follow these steps to build and run the MCP server image.

# Build the Docker image
docker build . --tag weather-my-mcp

# Run the MCP server container
docker run -i --rm weather-my-mcp

Available tools

get_water_level_condition

Retrieves water level conditions related to flood warnings for a specified district or state. District takes precedence if both are provided; use an empty string when a field is omitted.

get_warning

Fetches general weather warnings issued within a specified date range.

get_weather_forecast

Gets a weather forecast for a given location within a defined date range.

get_earthquake_news

Fetches earthquake news for a location within a specified date range.