Servidor MCP del clima de Corea

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.

Related MCP server: Node.js MCP Weather Server

Tabla de contenido

• Prerrequisitos

• Instalación

• Configurar los ajustes de MCP

• Referencia de API

• Expresiones de gratitud

• Licencia

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

1. Clonar el repositorio:

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

2. instalación de uv

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

3. Cree un entorno virtual e instale dependencias:

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

4. 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

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

uv run src/migrate.py

Usando Docker

1. Construya la imagen de Docker:

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

2. Ejecute el contenedor:

docker run py-mcp-ko-weather

Uso local

1. 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

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

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

2. 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

• Administración Meteorológica de Corea

• Portal de datos públicos

• Protocolo MCP

Licencia

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