Weather MCP Server

weather-mcp-server

A Model Context Protocol (MCP) server providing real-time weather data and news reports via OpenMeteo API.

Overview

weather-mcp-server is a Node.js/TypeScript server implementing the Model Context Protocol (MCP). It fetches weather data for any city using the OpenMeteo API and delivers concise, engaging weather news reports. The server exposes tools and prompts for integration with MCP clients.

Features

Real-time weather data retrieval for any city
Weather news reporting in broadcast style
MCP-compliant server with Express transport
Type-safe API using Zod validation
Modular codebase for easy extension

Installation

git clone https://github.com/your-org/weather-mcp-server.git
cd weather-mcp-server
cp .env.example .env # Set your PORT if needed
npm install
npm run build

Usage

Development mode (auto-reload):

npm run start:dev

The MCP server will run on the port specified in .env (default: 3000).

Docker Build & Debug (Taskfile)

This project uses Taskfile for Docker image build and debug automation.

Build Docker Image

task build:image

Builds the Docker image using buildx and tags it with both the version and latest.

Debug Docker Image

task debug:image

Runs the Docker image in interactive mode with Bash, loads environment variables from .env, and adds host.docker.internal:host-gateway for easy host-container communication.

Requirements:

Docker
Taskfile CLI

API

Tools

get-current-weather
- Description: Get the weather of a city.
- Input: { city: string }
- Output: Weather details (temperature, humidity, dew point, description).

Prompts

weather-news-report
- Description: Returns a concise, broadcast-style weather news report for a given message.

HTTP Endpoints

POST /mcp — Main MCP endpoint for requests
GET /mcp and DELETE /mcp — Not supported (returns 405)

Contributing

Pull requests and issues are welcome! Please follow conventional TypeScript/Node.js best practices.

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables users to get real-time weather data for any city and generate broadcast-style weather news reports. Uses the OpenMeteo API to provide current weather conditions including temperature, humidity, and weather descriptions.

Related MCP Servers

WeatherAPI MCP Server
swonixs
-
security
F
license
-
quality
Provides current weather and air quality data for any city using WeatherAPI, easily integrating with MCP clients like n8n and Claude Desktop App.
Last updated -
681
JavaScript
Weather MCP Server
JuanPedroSosa
-
security
F
license
-
quality
Provides tools to fetch real-time weather data from the National Weather Service API, allowing users to retrieve weather alerts by state and detailed forecasts by coordinates.
Last updated -
41
TypeScript
Weather Server
NeilJo-GY
-
security
F
license
-
quality
Provides global weather query services with features including real-time weather, weather forecasting, and multi-city weather comparison.
Last updated -
Python
Weather MCP Server
wudongjie
-
security
F
license
-
quality
Provides real-time weather information and forecasts, connecting AI assistants with live weather data for current conditions and multi-day forecasts for any location worldwide.
Last updated -
TypeScript

View all related MCP servers

Weather MCP Server