MCP Server IPMA

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.

Funcionalidades

• 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

Instalação e Configuração

Instalando via Smithery

Para instalar ipma-mcp-server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli@latest install @brandao-20/mcp_server_ipma --client claude

1. Clonar e Instalar Dependências

# Criar diretório do projeto
git clone https://github.com/brandao-20/mcp_server_ipma.git
cd mcp_server_ipma

# Instalar dependências
npm install

2. Correr o Projeto

npm start

3. Configurar no Claude Desktop

Editar o arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

Adicionar a configuração:

{
  "mcpServers": {
    "mcp_server_ipma": {
      "command": "node",
      "args": ["C:\\Users\\nome_user\\mcp_server_ipma\\src\\index.js"],
      "env": {}
    }
  }
}

4. Reiniciar o Claude Desktop

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

Ferramentas Disponíveis

get_locations

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

Exemplo de uso:

Quais cidades posso consultar a previsão do tempo?

get_weather_forecast

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

Parâmetros:

• city (obrigatório): Nome da cidade (exemplo "Braga")

• days (opcional): Número de dias de previsão

Exemplo de uso:

Qual é a previsão do tempo para Braga nos próximos 2 dias?

get_weather_warnings

Obter avisos meteorológicos ativos em Portugal.

Exemplo de uso:

Há algum aviso meteorológico ativo?

get_uv_forecast

Obter previsão do índice UV.

Exemplo de uso:

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

get_seismic_data

Obter dados sísmicos recentes.

Parâmetros:

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

Exemplo de uso:

Mostra-me os terramotos recentes nos Açores

Exemplos de Uso

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

• "Qual é a previsão do tempo para Viana do Castelo esta semana?"

• "Há avisos de chuva forte para hoje?"

• "Qual é o índice UV previsto para Braga?"

Desenvolvimento

Estrutura do Projeto

mcp_server_ipma/
├── src/
│   └── index.js          
├── package-lock.json               
├── package.json  
├── README.md              
└── smithery.yaml     
       

API IPMA

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

Links Úteis

• IPMA Official Website

• IPMA API Documentation

• Model Context Protocol

• Claude Desktop