Integrations

Uses the official Aviation Weather API Swagger definition to generate a type-safe API client that ensures proper typing and formatting for API calls.

Servidor MCP de meteorología aeronáutica

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona información meteorológica aeronáutica para la planificación de vuelos. Se conecta a la API de Meteorología Aeronáutica para obtener METAR, TAF, PIREP y otros datos.

DESCARGO DE RESPONSABILIDAD

NO UTILICE ESTA HERRAMIENTA PARA LA PLANIFICACIÓN DE VUELOS O LA TOMA DE DECISIONES DURANTE EL VUELO.

AVISO IMPORTANTE : Este servidor MCP de Aviation Weather proporciona datos meteorológicos de aviationweather.gov únicamente con fines informativos. La información proporcionada por esta herramienta NUNCA debe utilizarse como única fuente para la planificación de vuelos ni para la toma de decisiones durante el vuelo.

Los datos meteorológicos pueden estar incompletos, retrasados o ser inexactos. Además, el amplio modelo de lenguaje que los interpreta puede malinterpretar o representar incorrectamente información crucial. Consulte siempre las fuentes meteorológicas oficiales de aviación y obtenga información meteorológica adecuada de proveedores autorizados antes de cualquier vuelo.

Esta herramienta no está aprobada por la FAA, no sustituye a los servicios meteorológicos certificados y solo debe utilizarse como referencia complementaria. Los desarrolladores no se responsabilizan de las decisiones tomadas con base en la información proporcionada por esta herramienta.

SIEMPRE verifique la información meteorológica crítica a través de canales oficiales.

Características

Cliente API de tipo seguro generado automáticamente a partir de la definición oficial de Swagger de la API de Aviation Weather
Herramientas MCP para datos meteorológicos :
- get-metar : Obtenga observaciones meteorológicas actuales
- get-taf : Obtener pronósticos de aeródromos terminales
- get-pireps : Obtenga informes de pilotos cerca de un aeropuerto
- get-route-weather : Obtenga información meteorológica completa para una ruta entre dos aeropuertos

Configuración

Prerrequisitos

Node.js 18 o superior
npm o hilo
curl (para obtener el YAML de Swagger)

Instalación

Clonar este repositorio:
git clone https://github.com/yourusername/aviation-weather-mcp-server.git cd aviation-weather-mcp-server
Instalar dependencias:
npm install
Construya el servidor (esto obtendrá la última definición de Swagger, generará el cliente API y compilará TypeScript):
npm run build
Iniciar el servidor:
npm start

Uso con Claude para escritorio

Para utilizar este servidor con Claude for Desktop:

Edite su archivo de configuración de Claude for Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
Añade el servidor a la configuración:
{ "mcpServers": { "aviation-weather": { "command": "node", "args": [ "/absolute/path/to/aviation-weather-mcp-server/build/index.js" ] } } }
Reiniciar Claude para escritorio

Consultas de ejemplo

Una vez conectado con Claude, podrás hacerle preguntas como:

"¿Cuál es el clima actual en KJFK?"
"¿Hay un TAF disponible para KORD?"
Planeo volar de KBOS a KPHL mañana. ¿Qué tiempo hará?
"¿Hay algún PIREP cerca de KDEN?"

Desarrollo

Estructura del proyecto

src/index.ts : Código del servidor principal
packages/aviation-weath-api : Generación automática de cliente API para Aviation Weather .gov

Creación del cliente de meteorología aeronáutica

El proceso de construcción sigue estos pasos:

npm run aviation-weather-api:clean : eliminar el cliente existente
npm run aviation-weather-api:fetch : obtiene la última definición de Swagger de aviationweather.gov
npm run aviation-weather-api:generate : genera un cliente TypeScript tipado a partir de la definición de Swagger

Construir y ejecutar la aplicación

npm run build : Construye el cliente javascript
npm run start : Ejecuta el servidor MCP

Agregar más herramientas

Para agregar nuevas herramientas al servidor, siga este patrón:

server.tool(
  "tool-name",
  {
    // Zod schema for parameters
    param1: z.string().describe("Parameter description"),
    param2: z.number().optional().describe("Optional parameter")
  },
  async ({ param1, param2 }) => {
    try {
      // Implementation
      return {
        content: [{
          type: "text",
          text: "Response text"
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `Error: ${error.message}`
        }],
        isError: true
      };
    }
  }
);

Cómo funciona

El servidor obtiene la última definición de Swagger de aviationweather.gov
El generador OpenAPI crea un cliente de tipo seguro a partir de esta definición
El servidor utiliza este cliente para realizar llamadas API con la tipificación adecuada
El manejo de errores y el formato de las respuestas garantizan una experiencia fluida

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Proporciona información meteorológica de aviación a través de un servidor de Protocolo de Contexto de Modelo, lo que permite el acceso a METAR, TAF, PIREP y datos meteorológicos de ruta solo con fines informativos.

Aviation Weather MCP Server