OpenWeatherMap

Fornece dados meteorológicos abrangentes e previsões usando a API do OpenWeatherMap.

GitHub
5
Experimente este MCPPatrocinado

Documentação

Servidor MCP OpenWeatherMap

Um servidor Model Context Protocol (MCP) que fornece dados meteorológicos abrangentes e previsões por meio da API OpenWeatherMap. Este servidor permite que assistentes de IA acessem informações meteorológicas em tempo real, previsões, dados de qualidade do ar e serviços de localização.

OpenWeatherMap Server MCP server

Recursos

Ferramentas Meteorológicas

  • Clima Atual - Obtenha as condições atuais para qualquer local
  • Previsão do Tempo - Previsão do tempo para 5 dias com intervalos de 3 horas
  • Previsão Horária - Previsões horárias detalhadas para até 48 horas
  • Previsão Diária - Previsões meteorológicas diárias para até 8 dias com faixas de temperatura e dados astronômicos
  • Previsão Minuto a Minuto - Previsões de precipitação minuto a minuto para a próxima hora
  • Alertas Meteorológicos - Avisos e alertas meteorológicos ativos com classificação de severidade

Qualidade do Ar e Localização

  • Poluição do Ar Atual - Índice de qualidade do ar em tempo real e medições de poluentes
  • Informações de Localização - Geocodificação reversa para obter detalhes do local a partir de coordenadas
  • Clima OneCall - Dados meteorológicos abrangentes que combinam múltiplas previsões
  • Poluição do Ar - Dados históricos e previstos de qualidade do ar
  • Geocodificação - Converter nomes de locais em coordenadas

Instalação

Pré-requisitos

Configuração

  1. Clone o repositório:
git clone https://github.com/robertn702/mcp-openweathermap.git
cd mcp-openweathermap
  1. Instale as dependências:
bun install
  1. Configure suas variáveis de ambiente:
cp .env.example .env
# Edit .env and add your OpenWeatherMap API key

Variáveis de ambiente:

  • OPENWEATHER_API_KEY - Sua chave da API OpenWeatherMap (necessária apenas para transporte stdio)
  • PORT - Porta do servidor para transporte HTTP (padrão: 3000)
  • MCP_TRANSPORT - Tipo de transporte: stdio ou httpStream (padrão: stdio)
  • MCP_ENDPOINT - Caminho do endpoint HTTP (padrão: /stream)

Uso

Executando o Servidor

Transporte Stdio (padrão):

bun run src/main.ts

Transporte de Stream HTTP:

MCP_TRANSPORT=httpStream PORT=3000 bun run src/main.ts

Configuração do Claude Desktop

Adicione esta configuração às configurações MCP do seu Claude Desktop:

{
  "mcpServers": {
    "openweathermap": {
      "command": "npx",
      "args": ["mcp-openweathermap"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Ferramentas da API

Informações Meteorológicas

  • get-current-weather - Condições meteorológicas atuais
  • get-weather-forecast - Previsão de 5 dias
  • get-hourly-forecast - Previsões horárias (até 48 horas)
  • get-daily-forecast - Previsões diárias (até 8 dias)
  • get-minutely-forecast - Precipitação minuto a minuto

Alertas e Qualidade do Ar

  • get-weather-alerts - Avisos e alertas meteorológicos
  • get-current-air-pollution - Dados atuais de qualidade do ar
  • get-air-pollution - Previsões e histórico de qualidade do ar

Serviços de Localização

  • get-location-info - Geocodificação reversa a partir de coordenadas
  • geocode-location - Converter endereços em coordenadas
  • get-onecall-weather - Dados meteorológicos abrangentes

Desenvolvimento

Executando em Desenvolvimento

bun run src/main.ts

Testando com o MCP Inspector

bun run src/main.ts

Em seguida, conecte o MCP Inspector para testar as ferramentas interativamente.

Build

bun run build

Autenticação

Transporte Stdio: Requer a variável de ambiente OPENWEATHER_API_KEY.

Transporte HTTP: A chave da API OpenWeatherMap é passada como um token bearer nos cabeçalhos da solicitação HTTP. Nenhuma variável de ambiente é necessária.

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de recurso
  3. Faça suas alterações
  4. Adicione testes, se aplicável
  5. Envie um pull request

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Suporte