Servicio MCP de consulta meteorológica (versión Python) 🌤

Servicio MCP de consulta meteorológica basado en el mcp oficial de Python SDK (FastMCP). Se comunica mediante stdio con cualquier cliente MCP (como Claude Desktop, WorkBuddy, etc.), permitiendo que el asistente de IA pueda consultar el clima actual de una ciudad específica en tiempo real.

💡 Los datos meteorológicos provienen de Open-Meteo, sin necesidad de registro ni API Key.

✨ Características

• ⚡ Comunicación pura por stdio: plug-and-play, sin necesidad de abrir puertos ni servicios HTTP.

• 🌍 Nombres de ciudad en varios idiomas: admite nombres de ciudad en chino e inglés, como 北京, Beijing, Tokyo.

• 🔒 Cero claves: los datos provienen de Open-Meteo, no se recopilan datos personales ni se envían cuerpos de solicitud.

• 🛡 Manejo robusto de errores: cuando la ciudad no existe o hay problemas de red, devuelve mensajes amigables en chino sin que el servicio se detenga.

• 🎨 Formato de retorno amigable: texto estructurado + emoji, fácil de mostrar directamente en el cliente.

🛠 Herramientas proporcionadas

Ejemplo de retorno

📍 北京（中国）当前天气
🌤  天气：晴
🌡  温度：27.3°C（体感 28.1°C）
💧 湿度：52%
🍃 风速：12.4 km/h
🕒 观测时间：2026-08-19T13:00

📋 Requisitos del entorno

• Python >= 3.10 (se recomienda 3.13, verificado en este equipo)

• Se requiere acceso a Internet externo (para llamar a la API de Open-Meteo)

🚀 Instalación y ejecución

git clone https://github.com/<your-name>/weather-mcp-server-py.git
cd weather-mcp-server-py

# 创建虚拟环境（可选但推荐）
python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 运行（stdio 模式，通常由 MCP 客户端拉起）
python weather_server.py

Este servicio se comunica con el cliente mediante entrada/salida estándar (stdio), python weather_server.py se inicia por defecto en modo stdio.

🔌 Integración en clientes MCP

Tomando como ejemplo claude_desktop_config.json / mcp.json de Claude Desktop / WorkBuddy, agregue la siguiente configuración (reemplace python3 con la ruta absoluta del intérprete en su máquina, en Windows use python.exe):

{
  "mcpServers": {
    "weather": {
      "command": "python3",
      "args": ["/absolute/path/to/weather_server.py"]
    }
  }
}

Después de guardar y reiniciar el cliente, puede solicitar "consultar el clima de Beijing" en la conversación, y el modelo llamará automáticamente a la herramienta get_weather.

📁 Estructura del proyecto

weather-mcp-server-py/
├── weather_server.py   # MCP 服务主实现（FastMCP）
├── requirements.txt    # 依赖清单
└── README.md           # 本说明

🧰 Puntos técnicos

• Ciudad → latitud/longitud: se utiliza la API de geocodificación de Open-Meteo;

• Clima actual: se usa la API de pronóstico de Open-Meteo, el campo current obtiene de una sola vez temperatura / sensación térmica / humedad / velocidad del viento / código de clima;

• Código de clima → descripción en chino: tabla de mapeo de códigos de clima WMO integrada;

• Si la red no está disponible o no se encuentra la ciudad en tiempo de ejecución, se devuelven mensajes de error amigables en chino, garantizando que la herramienta siempre devuelva una cadena.

🤝 Contribuciones

Se aceptan Issues y Pull Requests, como agregar más indicadores meteorológicos, admitir más ejemplos de clientes o agregar pruebas.

📄 Licencia

MIT © 2026 weather-mcp-server-py contributors