mcp-estacion-meteorologica-iot

🌦️ MCP Estación Meteorológica IoT — BIU

Servidor Model Context Protocol (MCP) basado en FastMCP que expone los datos de la estación meteorológica IoT (ESP32-S3 + BME280 → AWS → Supabase) como herramientas consultables en lenguaje natural desde cualquier cliente MCP compatible (Claude Desktop, Claude.ai, Cursor, etc.).

Proyecto del caso de estudio Estación Meteorológica IoT, Maestría en Estructuras Computacionales, asignatura CSE611 — Broward International University.

Arquitectura completa del proyecto

ESP32-S3 + BME280 → WiFi → AWS API Gateway → AWS Lambda → Supabase PostgreSQL
                                                                    ↓
                                                    [Este servidor MCP en FastMCP Cloud]
                                                                    ↓
                                              Cualquier cliente MCP (Claude, Cursor, etc.)

Base de datos

Tabla sensor_readings en Supabase:

| Campo | Tipo | Descripción | |---|---|---| | id | UUID | Clave primaria | | device_id | VARCHAR | Identificador del sensor (ESP32S3_SENSOR_01) | | temperature | NUMERIC | Temperatura en °C | | humidity | NUMERIC | Humedad relativa en % | | pressure | NUMERIC | Presión atmosférica en hPa | | created_at | TIMESTAMPTZ | Marca de tiempo UTC |

Instalación local

pip install -r requirements.txt
cp .env.example .env
# Editar .env con tus credenciales reales de Supabase
python server.py

Variables de entorno

| Variable | Descripción | |---|---| | SUPABASE_URL | URL del proyecto Supabase | | SUPABASE_KEY | API Key de Supabase (anon o service_role) | | DEVICE_ID | ID del dispositivo a consultar (default: ESP32S3_SENSOR_01) |

Herramientas (Tools) disponibles

1. obtener_ultima_lectura() — Lectura más reciente del sensor
2. obtener_ultimas_lecturas(limite) — Historial de lecturas recientes
3. obtener_datos_grafico(limite) — Serie temporal para visualización
4. obtener_resumen_estacion(limite) — Estadísticas (promedio, máx, mín)
5. detectar_alertas() — Alertas según umbrales climáticos de Santiago
6. datos_para_dashboard(limite) — Toda la información agregada

Recursos (Resources) disponibles

• clima://config/bme280 — Especificaciones técnicas del sensor
• clima://config/umbrales — Umbrales de alerta configurados

Prompts disponibles

1. prompt_dashboard_tendencias(fecha_inicio, fecha_fin) — Genera HTML con análisis de tendencias entre fechas
2. prompt_dashboard_personalizado(tipo_dashboard, limite) — Genera HTML de dashboard ejecutivo o técnico

Umbrales de alerta (ajustados para Santiago, Chile)

| Condición | Umbral | |---|---| | Temperatura alta | ≥ 30°C | | Temperatura baja / helada | ≤ 5°C | | Humedad elevada | ≥ 85% | | Presión baja (posible lluvia) | < 1000 hPa |

Despliegue en FastMCP Cloud

1. Subir este repositorio a GitHub
2. Conectar en gofastmcp.com con tu cuenta de GitHub
3. Configurar las variables de entorno (SUPABASE_URL, SUPABASE_KEY, DEVICE_ID)
4. FastMCP Cloud genera una URL pública tipo https://tu-proyecto.fastmcp.app/mcp

Conexión desde Claude Desktop

{
  "mcpServers": {
    "estacion-meteorologica": {
      "url": "https://tu-proyecto.fastmcp.app/mcp"
    }
  }
}

---

Última actualización: Junio 2026