openweathermap-mcp-server

fgladisch/openweathermap-mcp-server

3.2

If you are the rightful owner of openweathermap-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The OpenWeatherMap MCP Server is a NestJS-based server that provides current weather data using the OpenWeatherMap API, designed for integration with MCP-compatible agent frameworks.

Tools
1
Resources
0
Prompts
0

OpenWeatherMap MCP Server

This project provides a simple Model Context Protocol (MCP) server for retrieving current weather data from the OpenWeatherMap API. It is built with NestJS and exposes a tool for use in MCP-compatible agent frameworks.

Features

  • Exposes a get-weather-forecast tool to fetch current weather for a given city
  • Integrates with OpenWeatherMap API (requires API key)
  • Designed for use in MCP agent orchestration systems

Prerequisites

  • Node.js (v18+ recommended)
  • Docker (optional, for containerized deployment)

Installation

npm install

Environment Variables

This project uses a .env file to configure the OpenWeatherMap API key. Copy .env.example to .env and fill in your API key:

cp .env.example .env
# Then edit .env and set your OWM_API_KEY

.env file:

OWM_API_KEY=your_openweathermap_api_key_here

NPM Scripts

  • npm run start — Start the server (production mode)
  • npm run start:dev — Start the server in watch mode (auto-reloads on changes)
  • npm run build — Compile TypeScript to JavaScript (output in dist/)

Usage

Local Development

  1. Ensure your .env file is set up as described above.
  2. Start the server: 
    npm run start:dev
    The server will listen on port 8088 by default.

Docker

You can build and run the server in a Docker container using the provided start.sh script:

./start.sh
  • This script builds the Docker image and runs the container, binding port 8088 on your host to port 8088 in the container.
  • If a .env file is present, it will be used to pass the OWM_API_KEY into the container automatically.

Tool: get-weather-forecast

  • Name: get-weather-forecast
  • Description: Get current weather for a city using OpenWeatherMap API (for 5 days).
  • Parameters:
    • city (string): City name to get weather for

License

MIT