pedroborgespj/Wheather-MCP-Server

Weather MCP Server

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

Description

This server implements a tool that allows users to get weather information for any city. It uses the Open-Meteo Geocoding API to convert city names into coordinates and then fetches detailed weather data using the Open-Meteo Weather API.

Features

• City weather lookup by name
• Current weather conditions including:
  • Temperature (2m above ground)
  • Relative humidity
  • Wind speed (10m above ground)
  • Precipitation
  • Rain
  • Showers
  • Cloud cover
  • Apparent temperature
• Hourly temperature forecasts

Technologies Used

• TypeScript
• Model Context Protocol SDK
• Open-Meteo API (Free and open-source weather API)

Tools

get-weather

Returns weather information for a specified city.

Parameters:

• city (string): The name of the city to get the weather for

Response: Returns a JSON object containing current weather conditions and hourly forecasts. If the city is not found, returns an appropriate error message.

APIs Used

• Open-Meteo Geocoding API: https://geocoding-api.open-meteo.com/v1/search
• Open-Meteo Weather API: https://api.open-meteo.com/v1/forecast

Setup

1. Clone the repository
2. Install dependencies:

npm install

3. Run the server:

npm start

Example Usage

The server can be used through any MCP-compatible client. When called, it will return detailed weather information in JSON format.

License

This project uses the Open-Meteo API which is free and open-source. Please check their terms of service for usage limits and conditions.

Dependencies

• @modelcontextprotocol/sdk
• zod