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

Name: Python MCP Korea Weather Service
Author: jikime

значок кузнеца Версия Лицензия

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

Обзор

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

Related MCP server: Weather MCP Server

Настраивать

Предпосылки

Питон 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.

One-click Deploy

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Python MCP Korea Weather Service