GribStream

GribStream Weather MCP

O GribStream Weather MCP é um servidor do Model Context Protocol hospedado para acesso de IA a dados de previsão meteorológica do GribStream, incluindo saídas de modelos NOAA e ECMWF.

Ele ajuda agentes de IA a descobrir conjuntos de dados de previsão, como NOAA GFS, HRRR e NBM ou ECMWF IFS, resolver variáveis e níveis exatos de previsão, validar corpos de requisição, construir requisições executáveis da API GribStream Weather e executar consultas meteorológicas ao vivo somente leitura após autorização OAuth.

Página inicial oficial da API meteorológica GribStream:

https://gribstream.com/

Endpoint MCP hospedado:

https://gribstream.com/mcp

Casos de Uso

Use o GribStream MCP quando quiser que uma ferramenta de IA:

• Liste conjuntos de dados meteorológicos públicos do GribStream.
• Escolha um modelo de previsão NOAA, ECMWF ou outro para uma região, horizonte ou tarefa meteorológica.
• Consulte dados de modelos de previsão numérica do tempo, como GFS, HRRR, NBM, IFS e outros expostos pelo GribStream.
• Encontre seletores exatos de variáveis, níveis e aliases.
• Construa uma requisição /timeseries para valores por tempo válido.
• Construa uma requisição /runs para comparar previsões entre execuções de modelos.
• Valide uma requisição da API GribStream antes de executá-la.
• Execute consultas ao vivo /timeseries ou /runs após autorização OAuth.
• Recupere grades densas de previsão como arquivos para download sem incorporar o resultado completo na conversa.
• Gere um comando curl copiável para a API GribStream Weather.

O servidor MCP hospedado expõe ferramentas de descoberta, consulta de seletores, construção de requisições e validação antes do OAuth. Ferramentas de consulta ao vivo /timeseries e /runs exigem OAuth. As descrições das ferramentas começam com NO AUTH / PUBLIC / READ-ONLY ou AUTH REQUIRED / DATA QUERY para que clientes de IA possam rotear corretamente tarefas de metadados e tarefas de consulta de dados ao vivo. Quando um cliente se conecta via OAuth, o GribStream pede que o usuário faça login e selecione um token ativo da API GribStream. Os tokens de acesso MCP são limitados a esse token de API selecionado, e o token bruto da API não é mostrado ao cliente MCP.

Conectar

Use o endpoint hospedado exatamente como mostrado em qualquer cliente MCP que suporte HTTP Streamable remoto:

https://gribstream.com/mcp

Não inclua pontuação final na URL.

Forma genérica de configuração:

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

Configuração de importação rápida do LobeHub:

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

Alguns clientes exigem um campo de transporte explícito:

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

OAuth

O OAuth é necessário para ferramentas de consulta ao vivo. A maioria dos clientes MCP deve descobrir o OAuth automaticamente a partir do endpoint hospedado, seja durante a configuração do conector ou quando o cliente solicitar ferramentas autenticadas. Se um cliente pedir campos manuais 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 descoberta OAuth:

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

O cliente OAuth é público e usa PKCE com token_endpoint_auth_method definido como none. Clientes desktop nativos podem usar URIs de redirecionamento de loopback, como http://localhost:{port}/..., http://127.0.0.1:{port}/... ou http://[::1]:{port}/.... Um formulário de configuração que exige um client secret não vazio está pedindo um fluxo de cliente confidencial e não é compatível com este fluxo OAuth MCP público.

Recursos do Servidor

O LobeHub e outros rastreadores MCP podem chamar as ferramentas MCP de "skills". O servidor MCP GribStream ao vivo expõe as seguintes skills/ferramentas, prompts e recursos.

Lista de Habilidades

Nome	Autenticação	Descrição
gribstream_list_datasets	Sem autenticação, público, somente leitura	Listar conjuntos de dados públicos do GribStream e metadados.
gribstream_get_dataset	Sem autenticação, público, somente leitura	Obter metadados públicos completos para um código de conjunto de dados.
gribstream_list_parameters	Sem autenticação, público, somente leitura	Listar resumos de parâmetros para um conjunto de dados.
gribstream_get_parameter	Sem autenticação, público, somente leitura	Obter metadados detalhados e variações exatas de seletores para um parâmetro de conjunto de dados.
gribstream_list_shared_parameters	Sem autenticação, público, somente leitura	Listar predefinições de parâmetros compartilhados normalizados.
gribstream_resolve_shared_parameter	Sem autenticação, público, somente leitura	Resolver uma predefinição de parâmetro compartilhado em variáveis e expressões nativas.
gribstream_get_expression_reference	Sem autenticação, público, somente leitura	Obter regras, exemplos e funções matemáticas da linguagem de expressão do GribStream.
gribstream_build_timeseries_request	Sem autenticação, público, somente leitura	Construir e validar uma requisição autenticada /timeseries copiável sem enviá-la.
gribstream_build_runs_request	Sem autenticação, público, somente leitura	Construir e validar uma requisição autenticada /runs copiável sem enviá-la.
gribstream_validate_request	Sem autenticação, público, somente leitura	Validar a forma da requisição, tuplas de seletores e sintaxe de expressões sem consultar valores meteorológicos.
gribstream_query_timeseries	OAuth obrigatório, consulta de dados	Executar uma requisição autenticada /timeseries e retornar valores meteorológicos reais.
gribstream_query_runs	OAuth obrigatório, consulta de dados	Executar uma requisição autenticada /runs e retornar valores meteorológicos reais entre execuções de modelos.

Skills/ferramentas públicas somente leitura são visíveis antes do OAuth. Skills/ferramentas de consulta ao vivo com OAuth podem ficar ocultas de tools/list até que o cliente conclua o OAuth ou envie um token Authorization: Bearer válido.

Lista de Prompts

Nome	Descrição
build_gribstream_api_request	Transformar uma pergunta meteorológica em uma requisição GribStream /timeseries ou /runs validada e um curl executável.
build_gfs_forecast_request	Criar uma requisição GFS validada para variáveis de previsão comuns em pontos ou grades.
build_historical_forecast_request	Construir uma requisição para previsões arquivadas ou previsões selecionadas por um corte de tempo de execução do modelo.
create_grid_request	Criar uma requisição GribStream sobre uma grade de latitude/longitude em vez de coordenadas de ponto.
compare_forecast_runs	Construir uma requisição /runs para comparar previsões de modelos entre execuções ou tempos de antecedência.
choose_weather_dataset	Escolher um conjunto de dados GribStream para uma região, horizonte, sinal meteorológico ou tarefa de previsão.
find_weather_variable	Encontrar os seletores exatos de parâmetros do conjunto de dados para um sinal meteorológico.

Lista de Recursos

URI	Tipo MIME	Descrição
gribstream://openapi	application/yaml	Especificação OpenAPI do GribStream legível por máquina.
gribstream://skill/gribstream-query	text/markdown	Instruções comportamentais neutras em relação ao fornecedor para ferramentas de IA que usam o GribStream.

Saída de Consulta ao Vivo

Ferramentas de consulta ao vivo autenticadas suportam resultados em CSV, JSON, NDJSON e Parquet. Resultados pequenos em CSV, JSON e NDJSON podem ser retornados inline. Defina delivery=url para grades densas ou resultados grandes para receber um resource_link HTTPS assinado de curta duração para o arquivo completo.

• A entrega por URL funciona com CSV, JSON, NDJSON e Parquet. Parquet sempre usa entrega por URL.
• Baixe a URL assinada exata uma vez sem um token de API. Isso consome o resultado do MCP; não é uma requisição direta separada à API GribStream.
• O limite de 10 MB max_bytes se aplica apenas a resultados MCP inline. Artefatos de URL usam um limite de tamanho separado configurado pelo servidor, então omita max_bytes ao usar delivery=url.
• Para grades densas, prefira Parquet quando um leitor compatível já estiver instalado; caso contrário, use CSV com delivery=url. Não instale uma dependência nem escreva um parser Parquet apenas para um resultado.
• Use uma única requisição de grade e divida apenas após um erro real de requisição ou de tamanho de artefato. Se a divisão for necessária, divida o tempo primeiro, as variáveis em segundo e o espaço por último.
• structuredContent inclui metadados como content_type, rows, bytes, columns, schema, delivery, cache_hit, signed_url_expires_at e suggested_filename quando aplicável.
• Resultados tabulares inline também incluem uma prévia além de request_hash, response_hash e result_hash. Use suggested_filename ao salvar vários resultados para que requisições repetidas ou comparações não sobrescrevam arquivos anteriores.
• As linhas são transmitidas de extração paralela e não têm garantia de ordenação. Ordene por forecasted_time para /timeseries, e por forecasted_at mais forecasted_time para /runs, antes de plotar ou comparar séries temporais.

Links

• Página inicial oficial da API meteorológica GribStream: https://gribstream.com/
• Endpoint: https://gribstream.com/mcp
• Página MCP: https://gribstream.com/mcp
• Ícone: https://gribstream.com/gribstream_small.png
• OpenAPI: https://gribstream.com/docs/openapi.yaml
• Documentação de configuração de IA: https://gribstream.com/ai
• Painel da API: https://gribstream.com/app/dashboard

Experimente

Depois de conectar o GribStream MCP a uma ferramenta de IA, pergunte:

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.

Se o seu cliente concluiu o OAuth, você também pode pedir que ele execute a consulta:

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

Para uma visualização de grade densa:

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

Ou:

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.

Mais exemplos:

• Exemplos de configuração de cliente
• Fluxos de trabalho de requisição meteorológica

Para a própria API GribStream, consulte a especificação OpenAPI.