# GeoGuessr MCP Server - Production Configuration # This file is for VPS deployment with nginx-proxy-manager and SSL # ============================================================================= # Docker Image Configuration (REQUIRED for production) # ============================================================================= # Your Docker Hub username - MUST match your pushed image DOCKER_USERNAME=yourusername # Docker image tag to use # Options: latest, v1.0.0, v1.1.0, etc. IMAGE_TAG=latest # ============================================================================= # GeoGuessr Authentication (REQUIRED for most features) # ============================================================================= # Your GeoGuessr _ncfa cookie for API authentication # # How to get your _ncfa cookie: # 1. Log in to GeoGuessr in your browser # 2. Open Developer Tools (F12 or Ctrl+Shift+I) # 3. Go to the "Application" or "Storage" tab # 4. Under "Cookies", find www.geoguessr.com # 5. Look for the cookie named "_ncfa" # 6. Copy its value and paste it below # # SECURITY WARNING: Keep this secret! Never commit to git. # Anyone with this cookie can access your GeoGuessr account. GEOGUESSR_NCFA_COOKIE=your_actual_ncfa_cookie_value_here # ============================================================================= # MCP Server Configuration # ============================================================================= # Transport protocol - keep as streamable-http for production MCP_TRANSPORT=streamable-http # Host - keep as 0.0.0.0 to accept connections from nginx-proxy-manager MCP_HOST=0.0.0.0 # Port - internal port, not exposed to internet (nginx-proxy-manager handles external) MCP_PORT=8000 # ============================================================================= # API Monitoring Configuration (RECOMMENDED for production) # ============================================================================= # Enable automatic API endpoint monitoring to detect schema changes MONITORING_ENABLED=true # Check endpoints every 24 hours MONITORING_INTERVAL_HOURS=24 # Directory to store schema cache (persisted in Docker volume) SCHEMA_CACHE_DIR=/app/data/schemas # ============================================================================= # Logging Configuration # ============================================================================= # Log level for production # Options: DEBUG (verbose), INFO (recommended), WARNING, ERROR, CRITICAL LOG_LEVEL=INFO # For troubleshooting, temporarily set to DEBUG: # LOG_LEVEL=DEBUG # ============================================================================= # Request Configuration # ============================================================================= # Request timeout in seconds (increase if API is slow) REQUEST_TIMEOUT=30.0 # Maximum retry attempts for failed requests MAX_RETRIES=3 # ============================================================================= # Production Notes # ============================================================================= # - This container is accessed through nginx-proxy-manager (firefly_network) # - SSL/HTTPS is handled by nginx-proxy-manager # - Port 8000 is NOT exposed to the internet # - Logs are available via: docker compose -f docker-compose.prod.yml logs -f # - Schema cache is persisted in volume: geoguessr-mcp-schemas-prod # # Deployment steps: # 1. Update DOCKER_USERNAME above # 2. Update GEOGUESSR_NCFA_COOKIE with your actual cookie # 3. Transfer this file to VPS as .env # 4. Run: docker compose -f docker-compose.prod.yml up -d # 5. Configure proxy host in nginx-proxy-manager (port 81) # 6. See DEPLOYMENT.md for detailed instructions