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

Related MCP server: Weather MCP Server

Prerrequisitos

• Node.js (v16 o superior)

• gestor de paquetes npm o yarn

Instalación

1. Clonar el repositorio:

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

2. Instalar dependencias:

npm install

3. 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:

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

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