Servidor MCP meteorológico

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona información meteorológica y alertas para ubicaciones en EE. UU. mediante la API del Servicio Meteorológico Nacional (NWS). Este servidor está diseñado para ser utilizado por agentes de IA a través del Protocolo de Contexto de Modelo.

Características

• Herramienta para recibir alertas meteorológicas para cualquier estado de EE. UU.

• Herramienta para obtener pronósticos meteorológicos detallados para cualquier ubicación de EE. UU. utilizando coordenadas

• Admite temperatura, condiciones del viento y descripciones breves de pronósticos.

• Datos en tiempo real del Servicio Meteorológico Nacional

Prerrequisitos

• Node.js (v16 o superior)

• gestor de paquetes npm o yarn

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

3. Construir la aplicación:

Herramientas MCP

El servidor proporciona dos herramientas MCP que pueden utilizar los agentes de IA:

recibir alertas

Reciba alertas meteorológicas para un estado específico de EE. UU.

Parámetros:

• state : código de estado de dos letras (por ejemplo, CA, NY)

Ejemplo de respuesta:

obtener pronóstico

Obtenga el pronóstico del tiempo para una ubicación específica utilizando coordenadas.

Parámetros:

• latitude : Latitud de la ubicación (-90 a 90)

• longitude : Longitud de la ubicación (-180 a 180)

Ejemplo de respuesta:

Estructura del proyecto

Detalles técnicos

• Creado con TypeScript

• Implementa el servidor del Protocolo de Contexto de Modelo (MCP)

• Utiliza @modelcontextprotocol/sdk para la implementación del servidor MCP

• Interfaces con la API del Servicio Meteorológico Nacional (NWS)

• Objetivo ES2022 con resolución de módulo Node16

Desarrollo

Para modificar o ampliar el servidor:

1. Realizar cambios en el archivo src/index.ts

2. Reconstruir la aplicación:

Dependencias

• @modelcontextprotocol/sdk: marco de implementación del servidor MCP

• zod: Comprobación y validación de tipos de tiempo de ejecución para parámetros de herramientas

• TypeScript: Dependencia de desarrollo para la seguridad de tipos

Licencia

ISC

Notas

• Este servidor solo funciona para ubicaciones de EE. UU., ya que utiliza la API del Servicio Meteorológico Nacional.

• Las solicitudes de API tienen una velocidad limitada y requieren un encabezado de agente de usuario

• Todas las coordenadas deben estar en formato de grados decimales.

• Esta no es una aplicación CLI independiente, sino un servidor que proporciona herramientas para agentes de IA a través del Protocolo de contexto de modelo.