Servicio Meteorológico de Corea del MCP de Python

Este es un servicio de información meteorológica coreano que utiliza el servidor MCP (Protocolo de Control de Modelos).

Cómo instalar

Clonar este 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 usando uv e instale los paquetes necesarios:

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

Establezca su clave API de Met Office en su archivo .env:

cp env.example .env
vi .env
KO_WEATHER_API_KEY=your_api_key_here

Migrar datos de las coordenadas de la cuadrícula meteorológica en Excel a SQLite.

uv run src/migrate.py

Cómo emitir una clave API de la Agencia Meteorológica

Acceda al portal de datos públicos , regístrese como miembro e inicie sesión.
Busque y solicite el uso de la API "Servicio de consulta de pronósticos a corto plazo ((antiguo)_Pronóstico de vecindario) de la Administración Meteorológica de Corea".
Después de la aprobación, configure la clave API recibida en el archivo .env.

Configuración de herramientas MCP

Abra el archivo ~/Library/Application\ Support/Claude/claude_desktop_config.json y agregue el servidor meteorológico.

{
    "mcpServers": {
      "Korea Weather": {
        "command": "/Users/jikime/Dev/.local/bin/uv",
        "args": [
          "--directory",
          "/Users/jikime/Dev/py-mcp-ko-weather",
          "run",
          "src/server.py"
        ]
      }
    }
}

Cómo correr

Inicie Claude Desktop para asegurarse de que esté agregado a sus herramientas.
Intenta escribir "¿Cómo es el clima en Yangjae 1-dong, Seocho-gu, Seúl?" en el cuadro de entrada del chat.

Descripción de la función

Este servidor MCP ofrece las siguientes características:

Herramientas

Obtener coordenadas de ubicación ( get_grid_location )
- Descripción: Recupera las coordenadas de la cuadrícula (nx, ny) utilizadas en la API de la Administración Meteorológica de Corea. Con base en la información de ciudad/provincia, distrito/condado y pueblo/aldea ingresada por el usuario, se buscan y devuelven desde la base de datos las coordenadas de la cuadrícula de la Administración Meteorológica de Corea para el área correspondiente. Esta herramienta es esencial para obtener las coordenadas precisas necesarias para las llamadas a la API de Administración Meteorológica.
- Parámetros:
  - city : nombre de la ciudad/provincia (p. ej., "Seúl")
  - gu : nombre del distrito/condado (por ejemplo, "Seocho-gu")
  - dong : nombre de un dong/ciudad/aldea (p. ej., "Yangjae 1-dong")
- Los datos se recuperan de una base de datos SQLite incorporada ( data/weather_grid.db ).
Obtener el pronóstico del tiempo ( get_forecast )
- Descripción: Proporciona información del pronóstico del tiempo para un área específica llamando a la API de pronóstico a corto plazo de la Administración Meteorológica de Corea. Recupera información meteorológica actual basándose en la información de ubicación ingresada por el usuario y las coordenadas de la cuadrícula. Esta herramienta incluye información meteorológica detallada, como temperatura, precipitaciones, condiciones del cielo, humedad, dirección y velocidad del viento, y proporciona pronósticos a corto plazo de hasta 6 horas.
- Parámetros:
  - city : nombre de la ciudad/provincia (p. ej., "Seúl")
  - gu : nombre del distrito/condado (por ejemplo, "Seocho-gu")
  - dong : nombre de un dong/ciudad/aldea (p. ej., "Yangjae 1-dong")
  - nx : coordenada de cuadrícula X
  - ny : coordenada de cuadrícula Y

Recursos

Manual del usuario del servicio meteorológico ( weather-instructions )

URI: weather-instructions
Descripción: Una guía detallada que explica cómo utilizar la Administración Meteorológica de Corea. Este recurso proporciona toda la información que necesita para utilizar el servicio, incluido cómo utilizar la herramienta, el flujo de trabajo y el formato de respuesta. LLM contiene información estructurada para permitir a los estudiantes utilizar eficazmente las herramientas meteorológicas.

Indicaciones

Solicitud de consulta de información meteorológica ( weather-query )

Descripción: Una plantilla de solicitud interactiva para consultar información meteorológica para la región de Corea. Estas indicaciones guían una conversación estructurada entre el usuario y el LLM, sugiriendo el orden apropiado de uso de la herramienta y el formato de respuesta. Cubre cómo recopilar la información necesaria de los usuarios y proporcionar pronósticos meteorológicos claros.

Licencia

Licencia Apache 2.0