MeteoSwiss Data
Fornece relatórios meteorológicos, pesquisa e conteúdo do site MeteoSwiss com suporte a múltiplos idiomas.
Documentação
🌦️ Ferramentas LLM do MeteoSwiss
Dados meteorológicos suíços para assistentes de IA — alimentados pelo MeteoSwiss Open Government Data (OGD), os mesmos dados por trás do aplicativo e do site do MeteoSwiss. Gratuito, sem necessidade de chave de API.
meteoswiss-mcp.ars.is — experimente o serviço hospedado instantaneamente, sem necessidade de configuração.
Este repositório também é uma resposta prática a uma questão de design: como você deve dar acesso a agentes de IA a um conjunto de dados públicos? Ele implementa o mesmo acesso aos dados do MeteoSwiss de duas formas — como uma habilidade de agente (instruções em markdown mais scripts bash, sem servidor) e como um servidor MCP (ferramentas estruturadas, correspondência difusa, cache, hospedado). As duas abordagens são comparadas honestamente no estudo de caso skill vs. MCP.
Uma terceira peça, meteoswiss-forecast-evals, demonstra design de interface orientado a avaliação: uma suíte promptfoo que mede quão bem 13 LLMs leem o JSON de previsão, o que resolveu uma decisão real de design — carimbos de data/hora em horário local superam UTC, com buscas em nível de hora alcançando ~100% vs. ~0%.
O que as ferramentas oferecem:
- Previsões de vários dias para ~6000 localidades suíças (códigos postais, estações, nomes de lugares)
- Medições em tempo real de ~300 estações (~160 meteorológicas completas + ~140 apenas de precipitação), atualizadas a cada 10 minutos
- Descoberta de estações por nome, cantão ou coordenadas GPS
- Monitoramento de pólen de ~15 estações em toda a Suíça
- Séries climáticas da Rede Climática Básica Nacional (NBCN), com décadas de histórico
- Busca e recuperação de conteúdo do site do MeteoSwiss
O que este repositório demonstra
- Uma habilidade de agente — ensine um agente a buscar dados abertos diretamente com
curl/awk/jq: ~630 linhas de markdown e bash, zero infraestrutura. → packages/meteoswiss-skills - Um servidor MCP — os mesmos dados como ferramentas estruturadas e validadas, com correspondência difusa de estações, geocodificação, cache em camadas com TTL, uma suíte de testes real, Docker e uma instância hospedada. → packages/meteoswiss-mcp
- Design de interface orientado a avaliação — trate a saída da ferramenta como uma interface para um modelo de linguagem e meça sua legibilidade antes de publicar. → packages/meteoswiss-forecast-evals
Leia a comparação: Skill vs. Servidor MCP: Duas Maneiras de Dar aos Agentes de IA os Mesmos Dados.
Escolha sua abordagem
Ambas as abordagens respondem às mesmas perguntas meteorológicas. Qual instalar depende do seu agente:
| Servidor MCP | Habilidade de Agente | |
|---|---|---|
| O que é | Servidor autônomo expondo 7 ferramentas estruturadas via MCP | Instruções em markdown + 5 scripts bash que o agente executa diretamente |
| Funciona com | Claude Desktop, Claude.ai, Cursor, qualquer cliente MCP | Claude Code, Cursor, qualquer agente com acesso ao shell |
| Cobertura | Previsões, clima atual, estações, pólen, séries climáticas, busca no site | Previsões, clima atual, estações, pólen |
| Extras | Correspondência difusa, geocodificação, cache, prompts em DE/FR/IT, JSON estruturado | Sem servidor, sem Node.js — apenas curl, awk, jq |
| Tamanho | ~6,6 mil linhas de TypeScript, testado em CI | ~630 linhas de markdown + bash |
| Instalação | Comando único (hospedado), npm ou Docker | Marketplace de plugins, CLI de Skills ou symlink |
Comparação completa — matriz de paridade, trade-offs de engenharia, custo de contexto, quando escolher cada um: docs/skill-vs-mcp.md.
Servidor MCP — início rápido
Use a instância hospedada (sem instalação):
# Claude Code
claude mcp add meteoswiss https://meteoswiss-mcp.ars.is/mcp
Para Cursor, instale a partir do Cursor Directory ou adicione manualmente via Configurações → MCP.
Ou hospede você mesmo com Docker:
docker run -p 3000:3000 ghcr.io/eins78/meteoswiss-mcp:latest
Consulte o README do meteoswiss-mcp para configuração do Claude Desktop, variáveis de ambiente e documentação completa.
Habilidade de agente — início rápido
Instale via o marketplace de plugins do Claude Code:
/plugin marketplace add eins78/meteoswiss-llm-tools
/plugin install meteoswiss-skills@meteoswiss-marketplace
Ou com a CLI de Skills:
pnpx skills add https://github.com/eins78/meteoswiss-llm-tools.git#packages/meteoswiss-skills --global --agent claude-code --all
Consulte o README do meteoswiss-skills para instalação manual e detalhes.
Ferramentas disponíveis (servidor MCP)
| Ferramenta | Descrição |
|---|---|
meteoswissLocalForecast | Previsões de vários dias por código postal, estação ou nome de lugar |
meteoswissCurrentWeather | Medições em tempo real (temperatura, vento, umidade, pressão) |
meteoswissStations | Busca na rede de estações por nome, cantão ou coordenadas |
meteoswissPollenData | Dados de concentração de pólen de estações de monitoramento |
meteoswissClimateData | Séries climáticas NBCN — temperatura, precipitação, insolação e indicadores climáticos com décadas de histórico |
search | Busca de conteúdo no site do MeteoSwiss (DE, FR, IT, EN) |
fetch | Recupera conteúdo completo de páginas do MeteoSwiss |
Exemplos de perguntas
Funciona com ambas as abordagens — basta perguntar em qualquer um dos quatro idiomas da Suíça:
- "Qual é a previsão do tempo para Zurique esta semana?"
- "Wie wird das Wetter in Bern morgen?"
- "Quelle est la météo à Genève?"
- "Che tempo fa a Lugano?"
Pacotes
| Pacote | Versão | Descrição |
|---|---|---|
meteoswiss-mcp |  | Servidor MCP com ferramentas estruturadas, correspondência difusa e geocodificação |
meteoswiss-skills | 1.0.0 | Habilidade de agente — acesso HTTP direto, sem necessidade de servidor |
meteoswiss-forecast-evals | — | Suíte de avaliação LLM para o formato JSON de previsão (autônoma, não é membro do workspace) |
Documentação
- Estudo de caso Skill vs. MCP — a comparação honesta das duas abordagens
- Resultados da avaliação: compreensão do JSON de previsão — a varredura horário-local-vs-UTC
- Guia do usuário do servidor MCP
- Índice de documentação
Desenvolvimento
git clone https://github.com/eins78/meteoswiss-llm-tools.git
cd meteoswiss-llm-tools
nvm use && pnpm install
Consulte o README de cada pacote para comandos específicos. O repositório usa changesets para versionamento.
Relatórios de teste manuais e pontuais (por exemplo, testes de ferramentas MCP ao vivo) ficam em docs/test-reports/.
Fonte de dados
Todos os dados meteorológicos vêm do MeteoSwiss Open Government Data (OGD) — a oferta oficial gratuita de dados do Escritório Federal de Meteorologia e Climatologia da Suíça. Os mesmos dados alimentam o aplicativo e o site do MeteoSwiss.
Licença
CC0-1.0 — domínio público