Intelligent Loxone Control for AI

# 1. Install uv (Python package manager)
# macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows:
# powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 2. Clone and setup project
git clone https://github.com/avrabe/mcp-loxone-gen1.git
cd mcp-loxone-gen1
uv sync

# 3. Configure credentials (one-time setup)
uvx --from . loxone-mcp setup

# Interactive setup wizard
./scripts/setup-https.sh

# Options available:
# 1. Development: Self-signed certificate
# 2. Development: mkcert (trusted by browsers)
# 3. Production: Use existing certificates  
# 4. Production: Generate CSR for CA signing
# 5. Show current configuration

# Quick self-signed setup
./scripts/generate-self-signed-cert.sh

# Start HTTPS server
export LOXONE_SSE_USE_HTTPS=true
uvx --from . loxone-mcp-sse

# Docker with HTTPS
docker-compose -f docker-compose.ssl.yml up

# Nginx reverse proxy with Let's Encrypt
docker-compose -f docker-compose.prod.yml up

# Environment variables for HTTPS
export LOXONE_SSE_USE_HTTPS=true
export LOXONE_SSL_CERT=certs/server.crt
export LOXONE_SSL_KEY=certs/server.key
export LOXONE_SSL_PORT=8443

# Test HTTPS endpoint with API key
curl -H "Authorization: Bearer your-api-key" \
  https://your-domain.com:8443/health

# Check what your system can do first
get_available_capabilities()         # Shows only your available features

# Auto-discovery finds your devices
discover_all_devices()               # Analyzes your specific setup
get_devices_by_category("Lighting")  # Only shows if you have lights

# Configuration-aware control
control_device("your_room_light", "on")    # Only works if device exists
get_weather_data()                   # Only available if weather sensors found
get_security_status()                # Only works with security devices

# Each feature automatically checks availability
if capabilities.has_weather:
    get_weather_data()                 # Only if weather stations exist
    
if capabilities.has_security:
    get_security_status()              # Only if security devices found

# Error handling with helpful guidance
> get_audio_zones()
{"error": "No audio devices available",
 "available_features": ["lighting", "blinds", "weather"]}

# Adaptive to your configuration - no hardcoded assumptions!