Servicio Meteorológico de Corea del MCP de Python

Servidor MCP del clima de Corea

Versión Licencia

Este servidor MCP (Protocolo de comunicación multiplataforma) proporciona acceso a las API de la Administración Meteorológica de Corea (KMA), lo que permite a los agentes de IA recuperar información del pronóstico meteorológico para ubicaciones en Corea del Sur.

Descripción general

Recupere coordenadas de cuadrícula precisas para las regiones administrativas de Corea
Obtenga pronósticos meteorológicos detallados a corto plazo para cualquier ubicación en Corea
Soporte para todas las divisiones administrativas de Corea (ciudad, distrito, barrio)
Respuestas de texto estructuradas y optimizadas para el consumo de LLM
Datos meteorológicos completos que incluyen temperatura, precipitaciones, estado del cielo, humedad, dirección y velocidad del viento.

Tabla de contenido

Configuración

Prerrequisitos

Python 3.12+
Credenciales API de la Administración Meteorológica de Corea
Puede obtener las credenciales de API registrándose en el Portal de datos públicos y solicitando acceso a la API "기상청_단기예보 ((구)_동네예보) 조회서비스".

Instalación

Clonar el repositorio:

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

instalación de uv

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

Cree un entorno virtual e instale dependencias:

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

Cree un archivo .env con sus credenciales de API de KMA:

cp env.example .env
vi .env

KO_WEATHER_API_KEY=your_api_key_here

Migrar los datos de coordenadas de la cuadrícula de Excel a SQLite:

uv run src/migrate.py

Usando Docker

Construya la imagen de Docker:

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

Ejecute el contenedor:

docker run py-mcp-ko-weather

Uso local

Ejecutar el servidor:

mcp run src/server.py

Configurar los ajustes de MCP

Agregue la configuración del servidor a su archivo de configuración de MCP:

Aplicación de escritorio de Claude

Para instalar automáticamente a través de Smithery :

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

Para instalar manualmente, abra ~/Library/Application Support/Claude/claude_desktop_config.json

Agregue esto al objeto mcpServers :

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

IDE de cursor

abrir ~/.cursor/mcp.json

Agregue esto al objeto mcpServers :

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

para Docker

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

Usando con Claude

Una vez configurado, puedes hacerle preguntas a Claude como:

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

Referencia de API

Herramientas

Obtener la ubicación de la cuadrícula

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

Recupera las coordenadas de la cuadrícula (nx, ny) utilizadas por la API de la Administración Meteorológica de Corea para la ubicación especificada. Esta herramienta busca en la base de datos las coordenadas exactas basándose en información de ciudad/provincia, distrito/condado y barrio/localidad.

Obtener pronóstico

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

Llama a la API de pronóstico a ultracorto plazo de KMA para proporcionar información meteorológica para una ubicación específica. Devuelve datos meteorológicos completos, como temperatura, precipitación, estado del cielo, humedad, dirección y velocidad del viento.

Recursos

Instrucciones meteorológicas

GET http://localhost:8000/weather-instructions

Proporciona documentación detallada sobre cómo utilizar el servidor MCP de Korea Weather, incluidos flujos de trabajo de herramientas y formatos de respuesta.

Indicaciones

Consulta del tiempo

El servidor incluye una plantilla de indicaciones estructurada para guiar conversaciones sobre consultas meteorológicas, garantizando una recopilación eficiente de información y una presentación clara de los datos del pronóstico.

Formato de respuesta

Las respuestas del pronóstico del tiempo se proporcionan en formato de texto estructurado, optimizado para el procesamiento 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
...

Expresiones de gratitud

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Servidor MCP que proporciona información meteorológica de Corea utilizando coordenadas de cuadrícula y la API de la Administración Meteorológica de Corea, lo que permite a los usuarios consultar las condiciones climáticas actuales y los pronósticos para ubicaciones específicas en Corea.

Related MCP Servers

Weather-MCP-Server
JackKuo666
-
security
F
license
-
quality
This is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API. Features Get weather alerts for a US state Get weather forecast for a specific location (using latitude and longitude)
Last updated -
Python
Weather MCP Server
CodeByWaqas
A
security
A
license
A
quality
An MCP server that provides real-time weather information including temperature, humidity, wind speed, and sunrise/sunset times through the OpenWeatherMap API.
Last updated -
1
Python
MIT License
Weather Query MCP Server
eternachen
-
security
F
license
-
quality
An MCP server implementation that allows users to fetch and display weather information for specified cities, including temperature, humidity, wind speed, and weather descriptions.
Last updated -
Python
Weather MCP Server
panzhenyao
-
security
A
license
-
quality
An MCP server that connects to OpenWeatherMap's API to provide current weather data and multi-day forecasts for locations worldwide in different measurement units.
Last updated -
12
TypeScript
MIT License

View all related MCP servers

Appeared in Searches

Help with building SwiftUI for iOS in Cursor

Python MCP Korea Weather Service