convez.ai
MCP ServerIntegração & APIsIntermediário
SHIVAM6192

MCP Weather & Air Quality Server

SHIVAM6192/MCP_WEATHER

Clima, qualidade do ar e conselhos de saúde em tempo real via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP pronto para produção que fornece ao Claude dados meteorológicos em tempo real, qualidade do ar, previsões de 5 dias e orientações de saúde para qualquer cidade no mundo. Utiliza APIs 100% gratuitas do Open-Meteo, sem necessidade de chaves pagas.

Instalação

$npx convez-ai SHIVAM6192/MCP_WEATHER

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar condições climáticas e qualidade do ar antes de atividades ao ar livre
  • Obter conselhos de saúde personalizados baseados em perfis (corredor, idoso, criança, respiratório)
  • Planejar eventos e viagens comparando condições entre múltiplas cidades
  • Integrar dados meteorológicos em fluxos de automação via Claude Desktop

Veredito

Implementação sólida de MCP server com integração prática a APIs abertas de qualidade. A falta de autenticação simplifica o deploy, mas o escopo é bastante específico — recomendado para quem realmente precisa de dados climáticos e ar quality no Claude Desktop.

README

A tradução para o português deste README ainda está na fila.

🌤️ Weather & Air Quality MCP Server

A production-ready MCP server that gives Claude real-time weather, air quality, forecasts, and health advisories for any city worldwide.

No paid API keys needed — uses Open-Meteo (100% free, no account required).


🗺️ Architecture

You (ask Claude)
     ↓
Claude Desktop / Claude Code
     ↓  (MCP protocol over stdio)
server.py  ← THIS FILE
     ↓  (HTTPS)
Open-Meteo API  (Free weather data)
Open-Meteo AQ API (Free air quality)

⚡ Quick Start

1. Get your Anthropic API Key

export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"

2. Install dependencies

pip install mcp httpx anthropic

3. Test the tools directly

python test_client.py

4. Connect to Claude Desktop

Edit your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "weather-advisory": {
      "command": "python",
      "args": ["/absolute/path/to/weather_mcp_server/server.py"],
      "env": {}
    }
  }
}

Restart Claude Desktop. You'll see a 🔨 tools icon appear.


🛠️ Available Tools

ToolDescription
get_current_weatherTemperature, humidity, wind, precipitation
get_air_qualityAQI, PM2.5, PM10, CO, NO₂, O₃
get_5day_forecast5-day daily forecast
get_health_advisoryCombined weather+AQ health advice by profile

Health profiles

  • general — Standard advice
  • runner — Outdoor exercise guidance
  • elderly — Heat/cold sensitivity
  • child — Sun protection, safe conditions
  • respiratory — Asthma/COPD considerations

💬 Example Prompts (in Claude Desktop)

"Is it safe to go for a run in Mumbai today?"

"What's the air quality like in Delhi right now?"

"Plan my outdoor wedding in Pune next 5 days — which day is best?"

"I have asthma. Should I go outside in Bangalore today?"

"Compare weather between London and Paris for my trip this week"

📁 File Structure

weather_mcp_server/
├── server.py                  ← Main MCP server (run this)
├── test_client.py             ← Test tools without Claude Desktop
├── requirements.txt           ← pip dependencies
├── claude_desktop_config.json ← Config template
└── README.md                  ← This file

🔧 Extending the Server

To add a new tool:

  1. Add it to list_tools() with name, description, inputSchema
  2. Add a handler async def handle_my_tool(args)
  3. Route it in call_tool() with elif name == "my_tool"

📡 APIs Used

APICostDocs
Open-Meteo WeatherFree, no keyhttps://open-meteo.com
Open-Meteo Air QualityFree, no keyhttps://open-meteo.com/en/docs/air-quality-api
Open-Meteo GeocodingFree, no keyhttps://open-meteo.com/en/docs/geocoding-api
Ver o original no GitHub

Bom para

Relacionados