Python MCP Корейская метеорологическая служба

MCP сервер погоды в Корее

Этот сервер MCP (мультиплатформенный протокол связи) обеспечивает доступ к API Корейской метеорологической администрации (KMA), позволяя агентам ИИ получать информацию о прогнозах погоды для различных мест в Южной Корее.

Обзор

Получить точные координаты сетки для корейских административных регионов
Получите подробные краткосрочные прогнозы погоды для любого места в Корее.
Поддержка всех административных единиц Кореи (города, районы, микрорайоны)
Структурированные текстовые ответы, оптимизированные для потребления LLM
Подробные данные о погоде, включая температуру, осадки, состояние неба, влажность, направление и скорость ветра

Настраивать

Предпосылки

Питон 3.12+
Учетные данные API Корейской метеорологической администрации
Вы можете получить учетные данные API, зарегистрировавшись на портале общедоступных данных и запросив доступ к API «기상청_단기예보 ((구)_동네예보) 조회서비스».

Установка

Клонируйте репозиторий:

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

УФ-установка

curl -LsSf https://astral.sh/uv/install.sh | sh

Создайте виртуальную среду и установите зависимости:

uv venv -p 3.12
source .venv/bin/activate
uv pip install -r requirements.txt

Создайте файл .env с вашими учетными данными API KMA:

cp env.example .env
vi .env

KO_WEATHER_API_KEY=your_api_key_here

Перенесите данные координат сетки из Excel в SQLite:

uv run src/migrate.py

Использование Докера

Создайте образ Docker:

docker build -t py-mcp-ko-weather .

Запустите контейнер:

docker run py-mcp-ko-weather

Использование локального

Запустите сервер:

mcp run src/server.py

Запустите MCP Inspector

mcp dev server.py

Настройте параметры MCP

Добавьте конфигурацию сервера в файл настроек MCP:

Приложение Клод для ПК

Для автоматической установки через Smithery :

npx -y @smithery/cli install @jikime/py-mcp-ko-weather --client claude

Для ручной установки откройте ~/Library/Application Support/Claude/claude_desktop_config.json

Добавьте это к объекту mcpServers :

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-ko-weather",
        "run",
        "src/server.py"
      ]
    }
  }
}

Курсор IDE

открыть ~/.cursor/mcp.json

Добавьте это к объекту mcpServers :

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-ko-weather",
        "run",
        "src/server.py"
      ]
    }
  }
}

для Докера

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "py-mcp-ko-weather"
      ]
    }
  }
}

Использование с Клодом

После настройки вы сможете задавать Клоду такие вопросы:

"서울특별시 서초구 양재1동의 날씨는?"
"부산광역시 해운대구 우동의 날씨 예보를 알려줘"
"경기도 성남시 분당구의 현재 기온은?"

Ссылка на API

Инструменты

Получить местоположение сетки

get_grid_location(city: str, gu: str, dong: str) -> dict

Извлекает координаты сетки (nx, ny), используемые API Корейской метеорологической администрации для указанного местоположения. Этот инструмент ищет в базе данных точные координаты на основе информации о городе/провинции, районе/уезде и районе/поселке.

Получить прогноз

get_forecast(city: str, gu: str, dong: str, nx: int, ny: int) -> str

Вызывает API ультракраткосрочного прогноза KMA для предоставления информации о прогнозе погоды для определенного местоположения. Возвращает комплексные данные о погоде, включая температуру, осадки, состояние неба, влажность, направление и скорость ветра.

Ресурсы

Прогноз погоды

GET weather://instructions

Содержит подробную документацию по использованию сервера Korea Weather MCP, включая рабочие процессы инструментов и форматы ответов.

Подсказки

Запрос погоды

Сервер включает в себя структурированный шаблон подсказок для ведения бесед по вопросам погоды, обеспечивая эффективный сбор информации и четкое представление данных прогноза.

Формат ответа

Ответы на прогнозы погоды предоставляются в структурированном текстовом формате, оптимизированном для обработки LLM:

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

Current conditions:
Temperature: 22.3°C
Sky condition: 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
...

Благодарности

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Python MCP Korea Weather Service

Integrations