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

Clonar el repositorio:

git clone https://github.com/akaramanapp/weather-mcp-server.git
cd weather-mcp-server

Instalar dependencias:

npm install

Construir la aplicación:

npm run build

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:

{
  "content": [
    {
      "type": "text",
      "text": "Active alerts for CA: ..."
    }
  ]
}

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:

{
  "content": [
    {
      "type": "text",
      "text": "Morning: Temperature: 72°F, Wind: 5mph NW, Partly cloudy..."
    }
  ]
}

Estructura del proyecto

weather/
├── src/
│   └── index.ts    # Main server code with MCP tool implementations
├── build/          # Compiled JavaScript files
├── package.json    # Project dependencies and scripts
└── tsconfig.json   # TypeScript configuration

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:

Realizar cambios en el archivo src/index.ts
Reconstruir la aplicación:

npm run build

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.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Un servidor de protocolo de contexto de modelo que proporciona a los agentes de IA herramientas para recuperar alertas meteorológicas y pronósticos detallados para ubicaciones de EE. UU. utilizando la API del Servicio Meteorológico Nacional.

Weather MCP Server