🌦️ 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.)

Related MCP server: ambient-mcp

Base de datos

Tabla sensor_readings en Supabase:

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

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)

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