Korean Weather

🚀 South Korea Weather MCP Server

This is a South Korea weather server built using the Multi-Platform Communication Protocol (MCP). It allows users to query real-time weather and ultra-short-term weather forecasts through the public data interface of the Korea Meteorological Administration (KMA).

✨ Features

• Retrieve weather data using grid coordinates (nx, ny).
• Provide detailed weather conditions, including temperature, precipitation type, precipitation amount, sky conditions, humidity, wind direction, and wind speed.
• Support weather information queries at the city, district, and street levels.
• Automatically generate an easy-to-understand weather forecast format.

📦 Installation

Environment Requirements

• Python 3.7 or higher.
• Necessary Python dependencies installed (e.g., requests).

Clone the Repository

git clone https://github.com/yourusername/py-mcp-ko-weather.git
cd py-mcp-ko-weather

Install Dependencies

pip install -r requirements.txt

🚀 Quick Start

1. Configure environment variables to specify the access key for the KMA API.
2. Start the server in the main function:

from server import start_server

if __name__ == "__main__":
    start_server()

📚 Documentation

💻 Usage Examples

Basic Usage

# Get grid location
location = get_grid_location("서울특별시", "서초구", "양재1동")
print(location)
# Output: {'nx': 61, 'ny': 125}

# Get weather forecast
forecast = get_forecast("서울특별시", "서초구", "양재1동", 61, 125)
print(forecast)

Core API Tools

Get Grid Location

def get_grid_location(city: str, gu: str, dong: str) -> dict:
    """
    Get the corresponding meteorological bureau grid coordinates through the specified administrative area information.
    
    Args:
        city (str): City/Province name
        gu (str): District/County name
        dong (str): Street/Town name
        
    Returns:
        dict: A dictionary containing nx and ny coordinates, or an empty dictionary if not found
    """

Get Weather Forecast

def get_forecast(city: str, gu: str, dong: str, nx: int, ny: int) -> str:
    """
    Call the KMA's ultra-short-term weather forecast API.
    
    Args:
        city (str): City/Province name
        gu (str): District/County name
        dong (str): Street/Town name
        nx (int): Abscissa
        ny (int): Ordinate
        
    Returns:
        str: Structured text information of the weather forecast
    """

Response Format

The weather forecast is returned in a structured text format for easy LLM processing:

Weather forecast for: 서울특별시 서초구 양재1동 (Coordinates: nx=61, ny=125)
Date: 2025-05-01
Time: 15:00

Current conditions:
Temperature: 22.3°C
Sky conditions: Mostly clear
Precipitation type: None
Precipitation probability: 0%
Humidity: 45%
Wind direction: Northwest
Wind speed: 2.3 m/s

Hourly forecast:
16:00 - Temperature: 21.8°C, Sky: Clear, Precipitation: None
17:00 - Temperature: 20.5°C, Sky: Clear, Precipitation: None
18:00 - Temperature: 19.2°C, Sky: Clear, Precipitation: None
...

👥 Contributors

• [Your Name] (your.email@example.com)

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.