Weather MCP Server

What is Weather MCP Server?

Weather MCP Server is a modular FastAPI-based weather server that provides live weather data from OpenWeatherMap. It supports Docker deployment and optional cloud hosting on Render or Heroku. It is intended for developers who need a containerized, API-driven weather endpoint.

How to use Weather MCP Server?

Create a .env file with your OPENWEATHER_API_KEY, build the Docker image with docker build -t weather-mcp ., then run it with docker run -p 8000:8000 weather-mcp-server. Access live weather at http://localhost:8000/weather?city=Tokyo. Obtain a free API key by signing up at openweathermap.org and copying it into your .env file.

Key features of Weather MCP Server

• Live weather data from OpenWeatherMap
• Dockerized for easy deployment
• FastAPI-based with auto-generated docs
• Optional cloud deployment (Render, Heroku)
• Environment variable configuration via .env

Use cases of Weather MCP Server

• Fetch current weather for any city via HTTP API
• Containerized weather service for integration into microservices
• Quick local weather endpoint for development and testing
• Deployable to cloud platforms like Render or Heroku

FAQ from Weather MCP Server

What API key do I need?

An OpenWeather API key. Sign up at openweathermap.org, go to API Keys, generate a key, and add it to .env as OPENWEATHER_API_KEY=your_key_here.

How do I run the server locally?

Build the Docker image with docker build -t weather-mcp . and run with docker run -p 8000:8000 weather-mcp-server. Then access http://localhost:8000/weather?city=CityName.

Can I deploy this server to a cloud provider?

Yes, the README mentions deployment on Render or Heroku with instructions in the /docs directory.

What is the server’s default transport and port?

The server runs on HTTP at port 8000 by default, served by Uvicorn via FastAPI.

How do I get the weather for a specific city?

Make a GET request to /weather?city=Tokyo (replace Tokyo with your desired city). The server will return live weather data from OpenWeatherMap.