Back to Browse

Weatherport MCP Server

Developer ToolsModerate5.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

OpenWeather current weather, 5-day forecast, One Call, air pollution, and geocoding.

About

OpenWeather current weather, 5-day forecast, One Call, air pollution, and geocoding.

Security Report

5.8
Moderate5.8Moderate Risk

weatherport is a straightforward OpenWeather client exposing five read-only weather tools over a CLI and stdio MCP server. The API key is read from OPENWEATHER_API_KEY, validated before any request, and sent only to the official api.openweathermap.org host; no exfiltration, shell execution, or hardcoded secrets were found. Minor notes are limited to the key being sent as a query parameter (visible in URLs) and the lack of a generic error-message sanitization for upstream responses. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

OPENWEATHER_API_KEYRequired

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "weatherport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/weatherport@0.1.0"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "your-openweather-api-key-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

weatherport

weatherport brings OpenWeather to the terminal and to MCP clients. It answers the questions people actually ask of that service: what is it like in a city right now, what is coming over the next five days in three-hour steps, what does the fuller One Call 3.0 view say for a precise point on the map, how clean is the air there, and where exactly is a place name? One binary serves both a command-line interface and a stdio MCP server.

An OpenWeather API key is required for every call. Put it in the OPENWEATHER_API_KEY environment variable; weatherport sends it to https://api.openweathermap.org as the appid query parameter and never prints it. When the variable is missing or blank, calls fail with an error that names it, before any request is made. Note that One Call 3.0 needs a separate upstream subscription in reality, even though it uses the same key.

Units are optional everywhere they apply: standard, metric, or imperial. Anything else is rejected before a request.

Install

npx @reneturcios/weatherport current Paris --units metric

Or run the container image:

docker run -i -e OPENWEATHER_API_KEY ghcr.io/cloudcorprecords/weatherport

The container defaults to the MCP server. Pass CLI arguments to use it as a CLI instead.

CLI

export OPENWEATHER_API_KEY=<your key>

weatherport current Paris --units metric
weatherport forecast Berlin --units imperial --count 5
weatherport onecall 51.5 -0.12 --units metric
weatherport pollution 51.5 -0.12
weatherport geocode Paris --limit 3

weatherport --version

Each command prints the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including a missing OPENWEATHER_API_KEY or an API error), 2 for usage errors.

MCP server

npx -y @reneturcios/weatherport mcp

MCP client configuration:

{
  "mcpServers": {
    "weatherport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/weatherport", "mcp"],
      "env": { "OPENWEATHER_API_KEY": "..." }
    }
  }
}

Tools

ToolInputWhat it returns
get_current_weatherlocation (required), units (optional)Current weather for a city.
get_forecastlocation (required), units, count (optional)5-day forecast in 3-hour steps.
get_onecall_weatherlat, lon (required), units (optional)One Call 3.0 current, hourly, and daily summaries.
get_air_pollutionlat, lon (required)Current AQI and pollutant components.
geocode_locationquery (required), limit (optional)Coordinate matches for a place name.

Latitude must be in [-90, 90] and longitude in [-180, 180]; out-of-range values are rejected before any request. HTTP failures surface the status plus OpenWeather's message field when the upstream JSON provides one.

Development

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!