Skip to main content
Glama

WeatherMCP

by Arliiii
GitHub
Python
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🌤️ WeatherMCP - Professional Weather MCP Server

A production-ready Model Context Protocol (MCP) server for weather data using OpenWeatherMap API.

✨ Features

  • Current Weather: Get weather by city name or coordinates
  • Temperature Units: Support for Celsius, Fahrenheit, and Kelvin
  • Weather Summaries: Concise summaries with motivational messages
  • API Status: Built-in connectivity testing and troubleshooting
  • Error Handling: Comprehensive error handling with helpful messages
  • STDIO Transport: Compatible with Smithery and other MCP clients
  • Docker Support: Containerized deployment ready

🚀 Quick Start

1. Get OpenWeatherMap API Key

  1. Visit OpenWeatherMap API
  2. Sign up for a free account
  3. Get your API key from the dashboard
  4. Wait up to 10 minutes for activation

2. Configure API Key

Option A: Use .env file (Recommended) Create a .env file in the project directory:

OPENWEATHER_API_KEY=your_actual_api_key_here DEFAULT_UNITS=celsius WEATHER_API_TIMEOUT=10

Option B: Set Environment Variable

Windows (Command Prompt):

set OPENWEATHER_API_KEY=your_actual_api_key_here

Windows (PowerShell):

$env:OPENWEATHER_API_KEY="your_actual_api_key_here"

Mac/Linux (Terminal):

export OPENWEATHER_API_KEY="your_actual_api_key_here"

3. Install Dependencies

pip install fastmcp httpx

4. Run the Server

python weather_server.py

🛠️ Configuration Options

Environment VariableDescriptionDefault
OPENWEATHER_API_KEYOpenWeatherMap API key (required)None
DEFAULT_UNITSDefault temperature unitscelsius
WEATHER_API_TIMEOUTAPI timeout in seconds10

📡 Available Tools

1. get_current_weather

Get current weather for a city.

Parameters:

  • city (string, required): City name
  • country_code (string, optional): ISO 3166 country code (e.g., 'GB', 'US')
  • units (string, optional): Temperature units - celsius, fahrenheit, or kelvin

Example:

{ "city": "London", "country_code": "GB", "units": "celsius" }

2. get_weather_by_coordinates

Get current weather by geographic coordinates.

Parameters:

  • latitude (float, required): Latitude (-90 to 90)
  • longitude (float, required): Longitude (-180 to 180)
  • units (string, optional): Temperature units

Example:

{ "latitude": 40.7128, "longitude": -74.0060, "units": "fahrenheit" }

3. get_weather_summary

Get a concise weather summary with motivational message.

Parameters:

  • city (string, required): City name

Example:

{ "city": "Tokyo" }

4. check_api_status

Check OpenWeatherMap API connectivity and configuration.

Parameters: None

📚 Available Resources

config://weather-api

Returns API configuration, supported features, and setup instructions.

data://supported-cities

Returns list of popular cities for testing with usage examples.

🐳 Docker Deployment

Build Image

docker build -t weather-mcp .

Run Container

docker run -e OPENWEATHER_API_KEY=your_api_key weather-mcp

🔧 Troubleshooting

Common Issues

"Module not found" error:

pip install fastmcp httpx

"API key not set" error:

# Check if environment variable is set echo $OPENWEATHER_API_KEY # Mac/Linux echo %OPENWEATHER_API_KEY% # Windows CMD

"Failed to connect" error:

# Test API key manually curl "https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_API_KEY"

API Status Codes

  • 200: Success
  • 401: Invalid API key
  • 404: City not found
  • 429: Rate limit exceeded
  • 500: Server error

Rate Limits

  • Free Tier: 60 calls/minute, 1,000,000 calls/month
  • Paid Tiers: Higher limits available

📋 Testing

Use the built-in check_api_status tool to verify your setup:

# Test the API status result = await client.call_tool("check_api_status", {}) print(result)

🌍 Supported Cities

The server supports all major cities worldwide. For best results:

  • Include country code for accuracy
  • Use English city names
  • Check spelling if city not found
  • Use ISO 3166-1 alpha-2 country codes (GB, US, JP, etc.)

📄 License

This project is open source and available under the MIT License.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📞 Support

For issues and questions:

  1. Check the troubleshooting section
  2. Use the check_api_status tool
  3. Verify your API key is active
  4. Check OpenWeatherMap service status "# mcp"

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

A production-ready Model Context Protocol server that provides weather data from OpenWeatherMap API, allowing users to query current weather by city name or coordinates with support for different temperature units.

  1. ✨ Features
    1. 🚀 Quick Start
      1. 1. Get OpenWeatherMap API Key
      2. 2. Configure API Key
      3. 3. Install Dependencies
      4. 4. Run the Server
    2. 🛠️ Configuration Options
      1. 📡 Available Tools
        1. 1. get_current_weather
        2. 2. get_weather_by_coordinates
        3. 3. get_weather_summary
        4. 4. check_api_status
      2. 📚 Available Resources
        1. config://weather-api
        2. data://supported-cities
      3. 🐳 Docker Deployment
        1. Build Image
        2. Run Container
      4. 🔧 Troubleshooting
        1. Common Issues
        2. API Status Codes
        3. Rate Limits
      5. 📋 Testing
        1. 🌍 Supported Cities
          1. 📄 License
            1. 🤝 Contributing
              1. 📞 Support

                Related MCP Servers

                • Weather MCP Server

                  isdaniel
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that retrieves current weather information for specified cities using the Open-Meteo API, requiring no API key.
                  Last updated -
                  3
                  16
                  Apache 2.0
                  • Linux
                  • Apple

                • Juhe Weather MCP Serverofficial

                  juhemcp
                  A
                  security
                  F
                  license
                  A
                  quality
                  Provides a Model Context Protocol server that enables large language models to query and retrieve real-time weather forecasts for cities and regions across China.
                  Last updated -
                  1

                • Caiyun Weather MCP Server

                  marcusbai
                  A
                  security
                  F
                  license
                  A
                  quality
                  A Model Context Protocol server that provides comprehensive weather data querying capabilities based on the Caiyun Weather API, supporting real-time weather, forecasts, and alerts with multi-language support.
                  Last updated -
                  7
                  6

                • Weather MCP

                  kaisumi
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that provides current weather information and 3-day forecasts for specified cities using the Open-Meteo API.
                  Last updated -

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/Arliiii/mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server