Weather

You can query real-time weather data for any city using this MCP server. It exposes a weather tool that returns the current temperature in Celsius and wind speed in km/h, along with geographic coordinates. It can run locally or inside a container, making it easy to deploy and use with MCP clients.

How to use

You interact with the weather MCP server through an MCP client by invoking the weather tool and providing a city name. The tool returns the city’s current temperature in Celsius, wind speed in km/h, and geographic coordinates. Use this to build weather-aware actions in your MCP-enabled workflows.

How to install

Choose your preferred deployment method. You can run a pre-built container or start the server directly from source.

# Docker (recommended)
docker pull 125478963/weather-mcp:latest

docker run -d -p 8000:8000 125478963/weather-mcp:latest

If you prefer to run locally from source, follow these steps. You need Python 3.11+ and optionally Docker for containerized runs.

# From Docker-based source (as in the example repository flow)
git clone https://github.com/rajeevchandra/weather-mcp-docker.git
cd weather-mcp-docker

# Build the Docker image (optional)
docker build -t weather-mcp .

docker run -d -p 8000:8000 weather-mcp

To run directly from Python without Docker, install dependencies and start the server.

# Prerequisites
# Python 3.11+ is required
# Docker is optional for containerization

# Local development
pip install -r requirements.txt
python server.py

# Quick health check (after starting)
curl http://localhost:8000/mcp

Configuration and endpoints

The MCP server runs on a local port and exposes the MCP endpoint at /mcp. By default, when using the Docker image, the server is accessible at http://localhost:8000/mcp.

Additional notes

Tools exposed by this MCP server include the weather tool that takes a city name and returns the current temperature and wind speed, along with geographic coordinates. The Open-Meteo API powers the weather data, and the service is designed to be easy to deploy with containerized or local runs.

Troubleshooting

If the server does not respond or cannot be reached, verify that a container is running on the expected port or that the local server is up.

# Check for running containers (Docker)
docker ps | grep weather-mcp

# View logs for troubleshooting
docker logs <container-id>

Available tools

weather

Returns current temperature in Celsius and wind speed in km/h for the specified city, along with geographic coordinates.