GribStream

GribStream Weather MCP

GribStream Weather MCP es un servidor de Model Context Protocol alojado para acceso de IA a datos de pronóstico del tiempo de GribStream, incluyendo salidas de modelos NOAA y ECMWF.

Ayuda a los agentes de IA a descubrir conjuntos de datos de pronóstico como NOAA GFS, HRRR y NBM o ECMWF IFS, resolver variables y niveles exactos de pronóstico, validar cuerpos de solicitud, construir solicitudes ejecutables de la API de GribStream Weather y ejecutar consultas meteorológicas en vivo de solo lectura después de la autorización OAuth.

Página oficial de la API meteorológica de GribStream:

https://gribstream.com/

Endpoint MCP alojado:

https://gribstream.com/mcp

Casos de Uso

Use GribStream MCP cuando quiera que una herramienta de IA:

• Liste conjuntos de datos meteorológicos públicos de GribStream.
• Elija un modelo de pronóstico NOAA, ECMWF u otro para una región, horizonte o tarea meteorológica.
• Consulte datos de modelos de predicción numérica del tiempo como GFS, HRRR, NBM, IFS y otros expuestos por GribStream.
• Encuentre selectores de variables, niveles y alias exactos.
• Construya una solicitud /timeseries para valores por tiempo válido.
• Construya una solicitud /runs para comparar pronósticos entre ejecuciones de modelos.
• Valide una solicitud de la API de GribStream antes de ejecutarla.
• Ejecute consultas en vivo /timeseries o /runs después de la autorización OAuth.
• Recupere cuadrículas de pronóstico densas como archivos descargables sin incrustar el resultado completo en la conversación.
• Genere un comando curl copiable y pegable para la API de GribStream Weather.

El servidor MCP alojado expone herramientas de descubrimiento, búsqueda de selectores, construcción de solicitudes y validación antes de OAuth. Las herramientas de consulta en vivo /timeseries y /runs requieren OAuth. Las descripciones de las herramientas comienzan con NO AUTH / PUBLIC / READ-ONLY o AUTH REQUIRED / DATA QUERY para que los clientes de IA puedan enrutar correctamente las tareas de metadatos y las tareas de consulta de datos en vivo. Cuando un cliente se conecta a través de OAuth, GribStream pide al usuario que inicie sesión y seleccione un token de API de GribStream activo. Los tokens de acceso MCP están limitados a ese token de API seleccionado, y el token de API sin procesar no se muestra al cliente MCP.

Conectar

Use el endpoint alojado exactamente como se muestra en cualquier cliente MCP que admita HTTP Streamable remoto:

https://gribstream.com/mcp

No incluya puntuación final en la URL.

Forma de configuración genérica:

{
  "mcpServers": {
    "gribstream": {
      "url": "https://gribstream.com/mcp"
    }
  }
}

Configuración de importación rápida de LobeHub:

{
  "mcpServers": {
    "gribstream": {
      "type": "http",
      "url": "https://gribstream.com/mcp"
    }
  }
}

Algunos clientes requieren un campo de transporte explícito:

{
  "mcpServers": {
    "gribstream": {
      "type": "streamable-http",
      "url": "https://gribstream.com/mcp"
    }
  }
}

OAuth

OAuth es necesario para las herramientas de consulta en vivo. La mayoría de los clientes MCP deberían descubrir OAuth desde el endpoint alojado automáticamente, ya sea durante la configuración del conector o cuando el cliente solicite herramientas autenticadas. Si un cliente pide campos manuales de OAuth 2.0, use:

Authorization URL: https://gribstream.com/authorize
Token URL: https://gribstream.com/token
Client ID: gribstream-mcp-public
Client Secret: leave empty; do not enter a value
Scopes: leave empty
Resource or audience, if requested: https://gribstream.com/mcp

Endpoints de descubrimiento de OAuth:

https://gribstream.com/.well-known/oauth-protected-resource/mcp
https://gribstream.com/.well-known/oauth-authorization-server

El cliente OAuth es público y usa PKCE con token_endpoint_auth_method establecido en none. Los clientes de escritorio nativos pueden usar URI de redirección de bucle local como http://localhost:{port}/..., http://127.0.0.1:{port}/... o http://[::1]:{port}/.... Un formulario de configuración que requiera un secreto de cliente no vacío está pidiendo un flujo de cliente confidencial y no es compatible con este flujo OAuth MCP público.

Características del Servidor

LobeHub y otros rastreadores MCP pueden llamar a las herramientas MCP "habilidades". El servidor MCP de GribStream en vivo expone las siguientes habilidades/herramientas, indicaciones y recursos.

Lista de Habilidades

Nombre	Autenticación	Descripción
gribstream_list_datasets	Sin autenticación, público, solo lectura	Listar conjuntos de datos públicos de GribStream y metadatos.
gribstream_get_dataset	Sin autenticación, público, solo lectura	Obtener metadatos públicos completos para un código de conjunto de datos.
gribstream_list_parameters	Sin autenticación, público, solo lectura	Listar resúmenes de parámetros para un conjunto de datos.
gribstream_get_parameter	Sin autenticación, público, solo lectura	Obtener metadatos detallados y variaciones exactas de selectores para un parámetro de conjunto de datos.
gribstream_list_shared_parameters	Sin autenticación, público, solo lectura	Listar ajustes preestablecidos de parámetros compartidos normalizados.
gribstream_resolve_shared_parameter	Sin autenticación, público, solo lectura	Resolver un ajuste preestablecido de parámetro compartido a variables y expresiones nativas.
gribstream_get_expression_reference	Sin autenticación, público, solo lectura	Obtener reglas, ejemplos y funciones matemáticas del lenguaje de expresiones de GribStream.
gribstream_build_timeseries_request	Sin autenticación, público, solo lectura	Construir y validar una solicitud de API /timeseries autenticada copiable y pegable sin enviarla.
gribstream_build_runs_request	Sin autenticación, público, solo lectura	Construir y validar una solicitud de API /runs autenticada copiable y pegable sin enviarla.
gribstream_validate_request	Sin autenticación, público, solo lectura	Validar la forma de la solicitud, las tuplas de selectores y la sintaxis de expresiones sin consultar valores meteorológicos.
gribstream_query_timeseries	Requiere OAuth, consulta de datos	Ejecutar una solicitud /timeseries autenticada y devolver valores meteorológicos reales.
gribstream_query_runs	Requiere OAuth, consulta de datos	Ejecutar una solicitud /runs autenticada y devolver valores meteorológicos reales entre ejecuciones de modelos.

Las habilidades/herramientas públicas de solo lectura son visibles antes de OAuth. Las habilidades/herramientas de consulta en vivo con OAuth pueden estar ocultas de tools/list hasta que el cliente complete OAuth o envíe un token Authorization: Bearer válido.

Lista de Indicaciones

Nombre	Descripción
build_gribstream_api_request	Convertir una pregunta meteorológica en una solicitud GribStream /timeseries o /runs validada y un curl ejecutable.
build_gfs_forecast_request	Crear una solicitud GFS validada para variables de pronóstico comunes en puntos o cuadrículas.
build_historical_forecast_request	Construir una solicitud para pronósticos archivados o pronósticos seleccionados por un corte de tiempo de ejecución del modelo.
create_grid_request	Crear una solicitud GribStream sobre una cuadrícula de latitud/longitud en lugar de coordenadas de puntos.
compare_forecast_runs	Construir una solicitud /runs para comparar pronósticos de modelos entre ejecuciones o tiempos de anticipación.
choose_weather_dataset	Elegir un conjunto de datos de GribStream para una región, horizonte, señal meteorológica o tarea de pronóstico.
find_weather_variable	Encontrar los selectores de parámetros exactos del conjunto de datos para una señal meteorológica.

Lista de Recursos

URI	Tipo MIME	Descripción
gribstream://openapi	application/yaml	Especificación OpenAPI de GribStream legible por máquina.
gribstream://skill/gribstream-query	text/markdown	Instrucciones de comportamiento neutrales al proveedor para herramientas de IA que usan GribStream.

Salida de Consulta en Vivo

Las herramientas de consulta en vivo autenticadas admiten resultados CSV, JSON, NDJSON y Parquet. Los resultados pequeños de CSV, JSON y NDJSON se pueden devolver en línea. Establezca delivery=url para cuadrículas densas o resultados grandes para recibir un resource_link HTTPS firmado de corta duración al archivo completo en su lugar.

• La entrega por URL funciona con CSV, JSON, NDJSON y Parquet. Parquet siempre usa entrega por URL.
• Descargue la URL firmada exacta una vez sin un token de API. Esto consume el resultado MCP; no es una solicitud directa separada a la API de GribStream.
• El límite de 10 MB de max_bytes se aplica solo a los resultados MCP en línea. Los artefactos de URL usan un límite de tamaño separado configurado por el servidor, así que omita max_bytes cuando use delivery=url.
• Para cuadrículas densas, prefiera Parquet cuando ya esté instalado un lector compatible; de lo contrario, use CSV con delivery=url. No instale una dependencia ni escriba un analizador de Parquet solo para un resultado.
• Use una solicitud de cuadrícula y solo divida después de una solicitud real o un error de tamaño de artefacto. Si es necesario dividir, divida primero el tiempo, luego las variables y por último el espacio.
• structuredContent incluye metadatos como content_type, rows, bytes, columns, schema, delivery, cache_hit, signed_url_expires_at y suggested_filename cuando corresponda.
• Los resultados tabulares en línea también incluyen una vista previa más request_hash, response_hash y result_hash. Use suggested_filename al guardar múltiples resultados para que las solicitudes repetidas o las comparaciones no sobrescriban archivos anteriores.
• Las filas se transmiten desde la extracción en paralelo y no se garantiza que estén ordenadas. Ordene por forecasted_time para /timeseries, y por forecasted_at más forecasted_time para /runs, antes de graficar o comparar series temporales.

Enlaces

• Página oficial de la API meteorológica de GribStream: https://gribstream.com/
• Endpoint: https://gribstream.com/mcp
• Página MCP: https://gribstream.com/mcp
• Icono: https://gribstream.com/gribstream_small.png
• OpenAPI: https://gribstream.com/docs/openapi.yaml
• Documentación de configuración de IA: https://gribstream.com/ai
• Panel de control de API: https://gribstream.com/app/dashboard

Pruébalo

Después de conectar GribStream MCP a una herramienta de IA, pregunte:

Use GribStream MCP to build a GFS 2m temperature timeseries request for Houston for tomorrow at 12:00 UTC. Validate the request and return a runnable curl command.

Si su cliente ha completado OAuth, también puede pedirle que ejecute la consulta:

Use GribStream MCP to run a GFS 2m temperature timeseries query for Houston for tomorrow at 12:00 UTC and return CSV.

Para una visualización de cuadrícula densa:

Using GribStream, plot the latest available ICON-D2 2 metre temperature forecast over Germany at 0.025 degree resolution as a beautiful PNG.

O:

Use GribStream MCP to find the best dataset for short-range precipitation forecasts in the continental United States. Explain the tradeoffs and build a validated example request.

Más ejemplos:

• Ejemplos de configuración de cliente
• Flujos de trabajo de solicitudes meteorológicas

Para la API de GribStream en sí, consulte la especificación OpenAPI.