Weather MCP Server

Name: Weather MCP Server
Author: yting27

@yting27

Repository

About Weather MCP Server

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

#agent #weather #mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "weather-my-mcp": {
      "command": "docker",
      "args": [
        "build",
        ".",
        "--tag",
        "weather-my-mcp"
      ]
    }
  }
}

Tools

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

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.

location_name: The name or identifier of the location for which the forecast is retrieved.

location: Name or identifier of the place where the earthquake(s) occurred.

Overview

What is Weather MCP Server?

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

How to use Weather MCP Server?

Install and configure the server for use with Claude Desktop by editing the claude_desktop_config.json file. The server can be run using uv (with the command uv --directory weather-my-mcp run weather.py) or via Docker (build the image with docker build . --tag weather-my-mcp, then run the container).

Key features of Weather MCP Server

Get water level conditions and flood warnings by district or state
Retrieve general weather warnings within a specified date range
Obtain weather forecasts for a location by name and date
Fetch earthquake news for a given location and date range
Powered by Malaysia’s official open data API (data.gov.my)

Use cases of Weather MCP Server

An LLM assistant answering “What is the weather forecast for Kuala Lumpur tomorrow?”
Checking flood warnings and water levels for a district during monsoon season
Retrieving recent earthquake reports for a region in Malaysia
Combining weather warnings with other data in a multi‑step reasoning workflow

FAQ from Weather MCP Server

What data does the server use?

It uses the Open API from Malaysia’s official open data portal (data.gov.my). Weather forecasts, warnings, water level data, and earthquake reports are fetched from that source.

How do I run the server with Claude Desktop?

Add the server configuration to claude_desktop_config.json. You can use either uv (with the command shown in the README) or Docker (after building the image). Full instructions are provided in the README.