Weekly Weather MCP

🚀 How to Use the Weather MCP Server

This guide provides a detailed introduction to using the Weather MCP server, including installation, configuration, function overview, usage instructions, troubleshooting, and development testing.

🚀 Quick Start

Installation and Configuration

1. Install Dependencies

   pip install openweathermap-api python-multipart
   

2. Set API Key
   • Set OPENWEATHER_API_KEY in environment variables:

     export OPENWEATHER_API_KEY="your_api_key"
     

   • Or pass the api_key parameter directly in the code.
3. Run the Server

   python3 weather_mcp_server.py
   

✨ Features

MCP Server Features

• Offers two tools: get_weather and get_current_weather.
• Utilizes OpenWeatherMap's One Call API 3.0.
• Supports 8 - day weather forecasts (including today and the next 7 days).
• Includes morning, afternoon, and evening weather data for each time period.
• Displays wind speed, precipitation, and other weather summaries.

Input and Output Examples

Example Input:

{
  "city": "New York",
  "state": "NY",
  "country": "US"
}

Example Output:

{
  "current_weather": {
    "temperature": 22,
    "condition": "Partly Cloudy",
    "wind_speed": 12,
    "humidity": 65
  },
  "hourly_forecast": [...],
  "daily_forecast": [...]
}

💻 Usage Examples

Basic Usage

# Get current weather
python3 weather_mcp_server.py --current-weather --city New York

# Get weather forecast
python3 weather_mcp_server.py --weather-forecast --location "Beijing,China"

Advanced Usage

• Supports multi - day weather data queries (up to 8 days).
• Allows specifying weather information for specific time points.
• Provides detailed meteorological data, including precipitation, wind direction, etc.

📚 Documentation

Troubleshooting

API Key Issues

1. Ensure you have subscribed to OpenWeatherMap's One Call API 3.0 plan.
2. Confirm that the API key is correctly set in the environment variables.
3. Check for cases of exceeding the free quota.

Other Common Issues

• Location Not Found: Check the accuracy of the input and try adding the country code.
• Rate Limit: Reduce the frequency of API calls or upgrade to a paid plan.

🔧 Technical Details

Development and Testing

Automated Testing

1. Unit Testing:

   python test_weather_mcp.py
   

2. Integration Testing:

   python integration_test.py
   

Manual Testing

# Run the test client
python3 weather_test_client.py --test-all

📄 Last Updated: November 4, 2023