Hurricane Tracker MCP Server

# Hurricane Tracker MCP Server Configuration
# Copy this file to .env and update the values as needed

# =============================================================================
# TRANSPORT CONFIGURATION
# =============================================================================
#MCP_TRANSPORT=stdio                    # stdio | http
#HTTP_PORT=8080                         # Port for HTTP transport
#HTTP_HOST=localhost                    # Host binding for HTTP transport

MCP_TRANSPORT=http                    # stdio | http
HTTP_PORT=8080                         # Port for HTTP transport
HTTP_HOST=0.0.0.0   # Host binding for HTTP transport
# =============================================================================
# HURRICANE DATA SOURCES
# =============================================================================
# NWS Weather API (Public - no key required)
NWS_API_BASE=https://api.weather.gov
NWS_USER_AGENT=hurricane-tracker-mcp/1.0.3

# NHC (National Hurricane Center) APIs (Public - no key required)
NHC_API_BASE=https://www.nhc.noaa.gov
NHC_GIS_BASE=https://mapservices.weather.noaa.gov/tropical/rest/services

# NOAA IBTrACS Historical Data (Public - no key required)
IBTRACS_API_BASE=https://www.ncei.noaa.gov/data/international-best-track-archive-for-climate-stewardship-ibtracs

# =============================================================================
# LLM OPTIMIZATION SETTINGS
# =============================================================================
MAX_INPUT_TOKENS=16000                 # Maximum tokens for tool input
MAX_OUTPUT_TOKENS=16000                # Maximum tokens for tool output
MAX_TOTAL_TOKENS=16000                 # Maximum total tokens for context window
PREFERRED_RESPONSE_SIZE=2000           # Preferred response size for optimization
DEFAULT_PAGE_SIZE=100                  # Default pagination size
ENABLE_RESPONSE_STREAMING=true         # Enable streaming responses

# =============================================================================
# CACHING CONFIGURATION
# =============================================================================
CACHE_MAX_SIZE=1000                    # Maximum cache entries
CACHE_CURRENT_HURRICANES_TTL=300000    # Current hurricanes TTL (5 minutes)
CACHE_FORECAST_TTL=900000              # Forecast TTL (15 minutes)
CACHE_ALERT_TTL=120000                 # Alert TTL (2 minutes)
CACHE_TRACK_TTL=600000                 # Track TTL (10 minutes)
CACHE_HISTORICAL_TTL=86400000          # Historical TTL (24 hours)
CACHE_GEOCODING_TTL=604800000          # Geocoding TTL (7 days)

# =============================================================================
# PERFORMANCE CONFIGURATION
# =============================================================================
MAX_RETRIES=3                          # Maximum retry attempts
REQUEST_TIMEOUT_MS=30000               # Request timeout (30 seconds)
CONNECTION_TIMEOUT_MS=10000            # Connection timeout (10 seconds)
API_TIMEOUT=10000                      # API request timeout
HTTP_TIMEOUT=60000                     # HTTP server timeout

# =============================================================================
# AUTHENTICATION & SECURITY
# =============================================================================
AUTH_ENABLED=false                     # Enable authentication
MCP_SERVER_API_KEYS=                   # Comma-separated API keys for MCP server access
SESSION_TIMEOUT=3600000                # Session timeout (1 hour)
ALLOWED_ORIGINS=*                      # Allowed CORS origins (comma-separated)
MAX_REQUEST_SIZE_BYTES=1048576         # Maximum request size (1MB)
ENABLE_INPUT_SANITIZATION=true        # Enable input sanitization

# =============================================================================
# RATE LIMITING CONFIGURATION
# =============================================================================
RATE_LIMIT_ENABLED=true                # Enable rate limiting
RATE_LIMIT_PER_CLIENT=100              # Requests per client per window
RATE_LIMIT_WINDOW_MS=60000             # Rate limit window (1 minute)
RATE_LIMIT_BURST=10                    # Burst allowance
RATE_LIMIT_BLOCK_DURATION=300000       # Block duration (5 minutes)
RATE_LIMIT_WHITELIST=                  # Whitelisted IPs (comma-separated)

# =============================================================================
# AUDIT LOGGING CONFIGURATION
# =============================================================================
ENABLE_AUDIT_LOGGING=true              # Enable comprehensive audit logging
AUDIT_LOG_FILE=false                   # Enable audit log file output
AUDIT_LOG_SYSLOG=false                 # Enable audit log syslog output
AUDIT_LOG_WEBHOOK_URL=                 # Webhook URL for audit log notifications

# =============================================================================
# RESILIENCE PATTERNS
# =============================================================================
# Circuit Breaker Configuration
CIRCUIT_BREAKER_FAILURE_THRESHOLD=5    # Failures before opening circuit
CIRCUIT_BREAKER_RESET_TIMEOUT_MS=60000 # Time before attempting reset
CIRCUIT_BREAKER_MONITORING_PERIOD_MS=10000  # Monitoring period

# Retry Configuration
RETRY_BASE_DELAY_MS=1000               # Base retry delay
RETRY_MAX_DELAY_MS=10000               # Maximum retry delay
RETRY_EXPONENTIAL_FACTOR=2             # Exponential backoff factor
RETRY_JITTER_FACTOR=0.1                # Jitter factor

# Bulkhead Configuration
BULKHEAD_MAX_CONCURRENT=10             # Maximum concurrent operations per bulkhead
BULKHEAD_MAX_QUEUE_SIZE=20             # Maximum queue size for pending operations
BULKHEAD_QUEUE_TIMEOUT=30000           # Timeout for queued operations

# =============================================================================
# UNDICI CONNECTION POOL CONFIGURATION
# =============================================================================
POOL_CONNECTIONS=50                    # Number of persistent connections
POOL_PIPELINING=10                     # HTTP/1.1 pipelining factor
KEEP_ALIVE_TIMEOUT=60000               # Keep-alive timeout
KEEP_ALIVE_MAX_TIMEOUT=600000          # Maximum keep-alive timeout
CONNECT_TIMEOUT=10000                  # Connection establishment timeout
BODY_TIMEOUT=300000                    # Response body timeout
HEADERS_TIMEOUT=30000                  # Response headers timeout

# =============================================================================
# MONITORING & OBSERVABILITY
# =============================================================================
LOG_LEVEL=info                         # debug | info | warn | error
LOG_FORMAT=json                        # json | pretty
PRETTY_LOGS=true                       # Pretty print logs in development
ENABLE_METRICS=true                    # Enable metrics collection
ENABLE_HEALTH_CHECKS=true              # Enable health check endpoints
ENABLE_TRACING=false                   # Enable distributed tracing

# Metrics Configuration
METRICS_PORT=9090                      # Metrics endpoint port
METRICS_PATH=/metrics                  # Metrics endpoint path
METRICS_INTERVAL=60000                 # Metrics collection interval

# Health Check Configuration
HEALTH_CHECK_INTERVAL_MS=30000         # Health check interval
HEALTH_CHECK_TIMEOUT_MS=5000           # Health check timeout
HEALTH_CHECK_PATH=/health              # Health check endpoint path

# =============================================================================
# DEVELOPMENT SETTINGS
# =============================================================================
NODE_ENV=development                   # development | test | production
DEBUG_MODE=false                       # Enable debug mode

# =============================================================================
# FEATURE FLAGS
# =============================================================================
ENABLE_HISTORICAL_SEARCH=true         # Enable historical hurricane search
ENABLE_DETAILED_FORECASTS=true        # Enable detailed forecast data
ENABLE_GEOJSON_RESPONSES=true          # Enable GeoJSON response format
ENABLE_ALERT_NOTIFICATIONS=true       # Enable alert notifications

# =============================================================================
# PRODUCTION DEPLOYMENT (Optional)
# =============================================================================
# SSL Configuration
HTTPS_ENABLED=false                    # Enable HTTPS
SSL_CERT_PATH=                         # SSL certificate path
SSL_KEY_PATH=                          # SSL private key path

# Container Configuration
CONTAINER_PORT=8080                    # Container port mapping

# =============================================================================
# NOTES
# =============================================================================
# 1. Never commit the actual .env file to version control
# 2. Use strong, unique values for any secrets or API keys
# 3. Adjust timeouts based on your network conditions
# 4. In production, use specific origins instead of wildcards
# 5. Monitor resource usage and adjust cache/connection limits accordingly
# 6. Enable audit logging for compliance requirements
# 7. Configure appropriate rate limits based on expected usage
# 8. Set up proper monitoring and alerting for production deployments