IPMA MCP Server

Um servidor MCP (Model Context Protocol) que fornece acesso aos dados meteorolgicos do IPMA (Instituto Portugus do Mar e da Atmosfera) atravs de linguagem natural.

Funcionalidades

Previso Meteorolgica: Obter previses para qualquer cidade de Portugal
Avisos Meteorolgicos: Consultar avisos ativos em tempo real
Dados Ssmicos: Aceder a informaes sobre terramotos recentes
Estaes Meteorolgicas: Observaes em tempo real das estaes do IPMA
ndice UV: Previses do ndice ultravioleta
Listagem de Locais: Ver todas as cidades disponveis

Instalao e Configurao

Instalando via Smithery

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

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

1. Clonar e Instalar Dependncias

# Criar diretrio do projeto
mkdir ipma-mcp-server
cd ipma-mcp-server

# Copiar os arquivos (index.ts, package.json, tsconfig.json)
# Criar estrutura de diretrios
mkdir src
# Mover index.ts para src/index.ts

# Instalar dependncias
npm install

2. Compilar o Projeto

npm run build

3. Configurar no Claude Desktop

Editar o arquivo de configurao do Claude Desktop:

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

Adicionar a configurao:

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

4. Reiniciar o Claude Desktop

Aps salvar a configurao, reinicie o Claude Desktop.

Ferramentas Disponveis

`get_weather_forecast`

Obter previso meteorolgica para uma cidade especfica.

Parmetros:

city (obrigatrio): Nome da cidade (ex: "Lisboa", "Porto", "Coimbra")
days (opcional): Nmero de dias de previso (padro: 5, mximo: 10)

Exemplo de uso:

Qual  a previso do tempo para Lisboa nos prximos 3 dias?

`get_weather_warnings`

Obter avisos meteorolgicos ativos em Portugal.

Exemplo de uso:

H algum aviso meteorolgico ativo?

`get_seismic_data`

Obter dados ssmicos recentes.

Parmetros:

area (opcional): "continent", "azores", "madeira", ou "all" (padro: "all")

Exemplo de uso:

Mostra-me os terramotos recentes nos Aores

`get_locations`

Listar todas as cidades/locais disponveis para previso.

Exemplo de uso:

Quais cidades posso consultar a previso do tempo?

`get_weather_stations`

Obter dados de observao das estaes meteorolgicas.

Exemplo de uso:

Quais so as condies meteorolgicas atuais nas estaes?

`get_uv_forecast`

Obter previso do ndice UV.

Exemplo de uso:

Qual  a previso do ndice UV para hoje?

Exemplos de Uso

Aps configurar o servidor, pode fazer perguntas como:

"Qual a previso 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 estaes meteorolgicas?"

Desenvolvimento

Estrutura do Projeto

ipma-mcp-server/
 src/
    index.ts          # Cdigo principal do servidor
 build/                # Cdigo compilado
 package.json          # Dependncias e scripts
 tsconfig.json         # Configurao TypeScript
 README.md            # Este arquivo

Scripts Disponveis

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

Adicionar Novas Funcionalidades

O servidor est estruturado de forma modular. Para adicionar nova funcionalidade:

Adicionar nova ferramenta em setupToolHandlers()
Implementar o mtodo correspondente
Definir interfaces TypeScript se necessrio
Recompilar e testar

API IPMA

Este servidor usa a API pblica do IPMA. Principais endpoints utilizados:

Previses meteorolgicas por cidade
Avisos meteorolgicos
Dados ssmicos
Observaes das estaes
ndice UV
Lista de locais disponveis

Consideraes

A API do IPMA gratuita mas requer uso responsvel
Dados so atualizados pelo IPMA duas vezes por dia (00UTC e 12UTC)
Todas as horas so em UTC
Para uso comercial, contactar o IPMA em webmaster@ipma.pt

Licena

MIT License

Contribuio

Contribuies so bem-vindas! Por favor:

Fork o projeto
Crie uma branch para sua funcionalidade
Commit suas mudanas
Push para a branch
Abra um Pull Request

Suporte

Se encontrar problemas:

Verifique se todos os arquivos esto no local correto
Confirme que as dependncias foram instaladas
Verifique o arquivo de configurao do Claude Desktop
Consulte os logs de erro do Claude Desktop

Links teis

服务配置

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

来源

来源：github
链接：https://github.com/DiogoAzevedo03/ipma-mcp-server