Weather

You run a weather MCP server that fetches real-time weather data from HeWeather and serves it to your MCP clients. It keeps weather information up to date for any city you query, and supports easy integration with your existing MCP setup.

How to use

Connect your MCP client to the server using the MCP URL and enable Server-Sent Events (SSE) mode for live updates. You can request real-time weather data for a specific city, and the server will return detailed information such as temperature, humidity, wind speed, and precipitation. Use the client to query by city name or location, and rely on the server to fetch fresh data from HeWeather via the API key you provide.

How to install

Prerequisites you need before installing: Python 3.13.2 (if you run locally) and Docker (optional for containerized deployment). You also need a HeWeather API key to access weather data.

# 1) Pull the Docker image
docker pull bellababy/mcp-server-weather-python:1.0.0

# 2) Run the container with your API key
docker run -d -p 8000:8000 -e WEATHER_API_KEY=YOUR_API_KEY bellababy/mcp-server-weather-python:1.0.0

Configuration and usage tips

Configure your MCP client (CherryStudio or any compatible client) to connect to the server at the following address and use SSE mode for real-time updates.

Additional setup for CherryStudio

In the client settings, add a new MCP server with the following details: server address: http://your-server-ip:8000 and enable SSE mode. This lets you query weather data directly from your MCP client.

Available tools

get_current_weather

Fetches real-time weather data for a specified city, returning core metrics such as temperature, humidity, wind speed, and precipitation.

fetch_weather_api

Handles communication with the HeWeather API using the provided API key to retrieve weather data.

format_weather_details

Formats the raw API response into a structured, MCP-friendly payload with all relevant weather details.