96 lines
2.8 KiB
Python
96 lines
2.8 KiB
Python
"""
|
|
GeoGuessr MCP Server - Main Entry Point.
|
|
|
|
This server provides tools for analyzing GeoGuessr game statistics,
|
|
with automatic API monitoring and dynamic schema adaptation.
|
|
"""
|
|
|
|
import asyncio
|
|
import logging
|
|
import sys
|
|
|
|
from mcp.server.fastmcp import FastMCP
|
|
|
|
from .config import settings
|
|
from .monitoring import endpoint_monitor
|
|
from .tools import register_all_tools
|
|
|
|
# Configure logging
|
|
logging.basicConfig(
|
|
level=getattr(logging, settings.LOG_LEVEL),
|
|
format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
|
|
handlers=[logging.StreamHandler(sys.stdout)],
|
|
)
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
# Create the MCP server instance
|
|
mcp = FastMCP(
|
|
"GeoGuessr Analyzer",
|
|
instructions="""
|
|
MCP server for analyzing GeoGuessr game statistics and optimizing gameplay strategy.
|
|
|
|
This server provides:
|
|
- Profile and statistics retrieval
|
|
- Game history and analysis
|
|
- Performance tracking and recommendations
|
|
- API monitoring with automatic schema adaptation
|
|
|
|
The server automatically tracks API endpoint changes and adapts to response format
|
|
modifications. Use the monitoring tools to check API status and discover available data.
|
|
|
|
Authentication:
|
|
- Use 'login(email, password)' to authenticate with your GeoGuessr account
|
|
- Or use 'set_ncfa_cookie(cookie)' with a cookie from your browser
|
|
- Or set GEOGUESSR_NCFA_COOKIE environment variable for automatic auth
|
|
|
|
Key tools:
|
|
- get_performance_summary() - Comprehensive overview of your account
|
|
- analyze_recent_games(count) - Analyze your recent gameplay
|
|
- get_strategy_recommendations() - Get personalized improvement tips
|
|
- check_api_status() - Monitor API endpoint availability
|
|
- explore_endpoint(path) - Discover new API endpoints
|
|
""",
|
|
host=settings.HOST,
|
|
port=settings.PORT,
|
|
)
|
|
|
|
# Register all tools
|
|
services = register_all_tools(mcp)
|
|
|
|
|
|
async def start_background_tasks():
|
|
"""Start background monitoring tasks."""
|
|
if settings.MONITORING_ENABLED:
|
|
logger.info("Starting API monitoring background task...")
|
|
await endpoint_monitor.start_periodic_monitoring()
|
|
|
|
|
|
async def stop_background_tasks():
|
|
"""Stop background monitoring tasks."""
|
|
if endpoint_monitor._running:
|
|
await endpoint_monitor.stop_monitoring()
|
|
|
|
|
|
def main():
|
|
"""Main entry point for the server."""
|
|
logger.info(
|
|
f"Starting GeoGuessr MCP Server on {settings.HOST}:{settings.PORT} "
|
|
f"with {settings.TRANSPORT} transport"
|
|
)
|
|
|
|
if settings.DEFAULT_NCFA_COOKIE:
|
|
logger.info("Default authentication cookie configured from environment")
|
|
else:
|
|
logger.warning(
|
|
"No default authentication cookie set. "
|
|
"Users will need to login or provide a cookie."
|
|
)
|
|
|
|
# Run the server
|
|
mcp.run(transport=settings.TRANSPORT)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|