Weather MCP Server

Weather MCP Server

What is Weather MCP Server about?

A lightweight Model Context Protocol (MCP) server that retrieves weather data from the Open‑Meteo service and returns it in a format consumable by LLMs or other clients. It supports fetching the latest conditions for a city, obtaining weather forecasts over a date range, and getting the current time in any IANA timezone.

How to use Weather MCP Server?

1. Install the package via pip: pip install mcp-weather-server.
2. Add the server entry to your cline_mcp_settings.json:

   {
     "mcpServers": {
       "weather": {
         "command": "python",
         "args": ["-m", "mcp_weather_server"],
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. Invoke the provided tools (get_weather, get_weather_by_datetime_range, get_current_datetime) using the MCP XML syntax shown in the README.

Key features of Weather MCP Server

• Current weather lookup by city name.
• Historical/forecast range lookup with start and end dates (ISO‑8601 format).
• Timezone‑aware current datetime retrieval.
• No API key required; utilizes the free Open‑Meteo endpoint.
• Simple Python‑based deployment via a single module run command.

Use cases of Weather MCP Server

• Enriching conversational AI responses with up‑to‑date weather information.
• Building location‑aware assistants that need to schedule activities based on weather predictions.
• Providing contextual time data for global users in chatbots or automated scripts.
• Integrating weather data into workflow automations without external API management.

FAQ from the Weather MCP Server

• Do I need an API key? No, the server uses Open‑Meteo, which is open and free.
• Which cities are supported? Any city recognized by Open‑Meteo; the service resolves city names to coordinates.
• What date formats are accepted? ISO 8601 dates (YYYY‑MM‑DD).
• What if I don’t pass a timezone? The get_current_datetime tool defaults to UTC.
• Can I run the server from any directory? Yes. Either run python -m mcp_weather_server directly or set PYTHONPATH to the package root if needed.

Weather MCP Server

A Model Context Protocol (MCP) server that provides weather information using the Open-Meteo API.

Features

• Get current weather information for a specified city.

Installation

Pip Installation and Usage, This package can be installed using pip:

pip install mcp_weather_server

This server is designed to be installed manually by adding its configuration to the cline_mcp_settings.json file.

1. Add the following entry to the mcpServers object in your cline_mcp_settings.json file:

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": [
        "-m",
        "mcp_weather_server"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

2. Save the cline_mcp_settings.json file.

Configuration

This server does not require an API key. It uses the Open-Meteo API, which is free and open-source.

Usage

This server provides several tools: get_weather, get_weather_by_datetime_range, and get_current_datetime.

get_weather

Retrieves the current weather information for a given city.

Parameters:

• city (string, required): The name of the city.

Example:

To get the weather in Taipei, you would use the tool like this:

<use_mcp_tool>
<server_name>weather</server_name>
<tool_name>get_weather</tool_name>
<arguments>
{
  "city": "Taipei"
}
</arguments>
</use_mcp_tool>

get_weather_by_datetime_range

Retrieves weather information for a specified city between start and end dates.

Parameters:

• city (string, required): The name of the city.
• start_date (string, required): Start date in format YYYY-MM-DD (ISO 8601).
• end_date (string, required): End date in format YYYY-MM-DD (ISO 8601).

Example:

To get the weather in London between 2024-01-01 and 2024-01-07, you would use the tool like this:

<use_mcp_tool>
<server_name>weather</server_name>
<tool_name>get_weather_by_datetime_range</tool_name>
<arguments>
{
  "city": "London",
  "start_date": "2024-01-01",
  "end_date": "2024-01-07"
}
</arguments>
</use_mcp_tool>

get_current_datetime

Retrieves the current time in a specified timezone.

Parameters:

• timezone_name (string, required): IANA timezone name (e.g., 'America/New_York', 'Europe/London'). Use UTC timezone if no timezone provided by the user.

Example:

To get the current time in New York, you would use the tool like this:

<use_mcp_tool>
<server_name>weather</server_name>
<tool_name>get_current_datetime</tool_name>
<arguments>
{
  "timezone_name": "America/New_York"
}
</arguments>
</use_mcp_tool>

For developers

Change Working Directory Before Running Python

python -m mcp_weather_server

Or if you want Python to find your package no matter where you run from, you can set PYTHONPATH:

set PYTHONPATH=C:\xxx\mcp_weather_server\src
python -m mcp_weather_server