IPMA MCP Server

Um servidor MCP (Model Context Protocol) que fornece acesso aos dados meteorológicos do IPMA (Instituto Português do Mar e da Atmosfera) através de linguagem natural.

- Previsão Meteorológica: Obter previsões para qualquer cidade de Portugal
- Avisos Meteorológicos: Consultar avisos ativos em tempo real
- Dados Sísmicos: Aceder a informações sobre terramotos recentes
- Estações Meteorológicas: Observações em tempo real das estações do IPMA
- Índice UV: Previsões do índice ultravioleta
- Listagem de Locais: Ver todas as cidades disponíveis

Para instalar ipma-mcp-server para Claude Desktop automaticamente viaSmithery:

npx -y @smithery/cli install @DiogoAzevedo03/ipma-mcp-server --client claude

# Criar diretório do projeto mkdir ipma-mcp-server cd ipma-mcp-server # Copiar os arquivos (index.ts, package.json, tsconfig.json) # Criar estrutura de diretórios mkdir src # Mover index.ts para src/index.ts # Instalar dependências npm install

{ "mcpServers": { "ipma-weather": { "command": "node", "args": ["/caminho/completo/para/ipma-mcp-server/build/index.js"], "env": {} } } }

Após salvar a configuração, reinicie o Claude Desktop.

Obter previsão meteorológica para uma cidade específica.

- city(obrigatório): Nome da cidade (ex: "Lisboa", "Porto", "Coimbra")
- days(opcional): Número de dias de previsão (padrão: 5, máximo: 10)

Qual é a previsão do tempo para Lisboa nos próximos 3 dias?

Obter avisos meteorológicos ativos em Portugal.

- area(opcional): "continent", "azores", "madeira", ou "all" (padrão: "all")

Mostra-me os terramotos recentes nos Açores

Listar todas as cidades/locais disponíveis para previsão.

Quais cidades posso consultar a previsão do tempo?

Obter dados de observação das estações meteorológicas.

Quais são as condições meteorológicas atuais nas estações?

Qual é a previsão do índice UV para hoje?

Após configurar o servidor, pode fazer perguntas como:

- "Qual é a previsão do tempo para o Porto esta semana?"
- "Há avisos de chuva forte para hoje?"
- "Mostra-me os terramotos recentes em Portugal"
- "Qual é o índice UV previsto para Lisboa?"
- "Que temperatura está a fazer nas estações meteorológicas?"

ipma-mcp-server/ ├── src/ │ └── index.ts # Código principal do servidor ├── build/ # Código compilado ├── package.json # Dependências e scripts ├── tsconfig.json # Configuração TypeScript └── README.md # Este arquivo

- npm run build: Compilar TypeScript
- npm run dev: Modo de desenvolvimento com watch
- npm start: Executar o servidor compilado

O servidor está estruturado de forma modular. Para adicionar nova funcionalidade:
- Adicionar nova ferramenta emsetupToolHandlers()
- Implementar o método correspondente
- Definir interfaces TypeScript se necessário
- Recompilar e testar

Este servidor usa a API pública do IPMA. Principais endpoints utilizados:

- Previsões meteorológicas por cidade
- Avisos meteorológicos
- Dados sísmicos
- Observações das estações
- Índice UV
- Lista de locais disponíveis

- A API do IPMA é gratuita mas requer uso responsável
- Dados são atualizados pelo IPMA duas vezes por dia (00UTC e 12UTC)
- Todas as horas são em UTC
- Para uso comercial, contactar o IPMA emwebmaster@ipma.pt

- IPMA Official Website
- IPMA API Documentation
- Model Context Protocol
- Claude Desktop

Access global weather data and forecasts using the OpenMeteo API, including current conditions, historical data, and location search.