mcp-server-vanmoof

Instructions

    Retrieves total city rides summary from VanMoof riders.


    Returns:
        The a summary of the total rides of the VanMoof rider city if authentication is successful, otherwise None.
        The following information is returned:
        - City name
        - Average distance in km
        - Total Rides
        - Average duration in minutes
        - Location in latitude and longitude
    

Implementation Reference

• server.py:375-443 (handler)

  The handler function decorated with @mcp.tool(), which registers and implements the 'get_city_rides_thisweek' tool. It authenticates with VanMoof API, retrieves necessary IDs and preferences, fetches this week's rides data, extracts city summary, processes average duration, adds location info, and returns the result.

  @mcp.tool()
  def get_city_rides_thisweek()-> Dict[str, Any]:
      """
      Retrieves total city rides summary from VanMoof riders.
  
  
      Returns:
          The a summary of the total rides of the VanMoof rider city if authentication is successful, otherwise None.
          The following information is returned:
          - City name
          - Average distance in km
          - Total Rides
          - Average duration in minutes
          - Location in latitude and longitude
      """
      # Get the Bearer token from the authenticate method
      token = VanMoofAPI.get_vanmoof_token(VANMOOF_USERNAME, VANMOOF_PASSWORD)
      application_token = VanMoofAPI.get_application_token(token)
      if not application_token:
          return {"error": "Authentication failed"}
  
      # Get the riderId from the customer data
      customerData = VanMoofAPI.get_customer_data()
      riderId = customerData.get('data', {}).get('uuid')
      if not riderId:
          return {"error": "RiderId not found"}
      bikeId = customerData.get('data', {}).get('bikes', [{}])[0].get('id')
      if not bikeId:
          return {"error": "BikeId not found"}
      country = customerData.get('data', {}).get('country')
      if not country:
          return {"error": "CountryCode not found"}
      
      # Get the riders preferences and city
      riderPreferences = VanMoofAPI.get_rider_preferences()
      riderCity = riderPreferences.get('city')
      # Get city name from the city code
      cities = VanMoofAPI.get_vanmoof_cities()
      location= next((city['location'] for city in cities if city['code'] == riderCity), None)
  
      last_seen_week = datetime.now().strftime("%Y-%m-%d")
  
      # Ensure last_seen_week is the Monday of the week
      date_obj = datetime.strptime(last_seen_week, "%Y-%m-%d")
      monday = date_obj - timedelta(days=date_obj.weekday())
      last_seen_week = monday.strftime("%Y-%m-%d")
  
      url = f"https://tenjin.vanmoof.com/api/v1/rides/{riderId}/{bikeId}/weekly"
      querystring = {"lastSeenWeek": last_seen_week, "limit": str(1)}
  
      headers = {
          "authorization": f"Bearer {application_token}",
          "api-key": "fcb38d47-f14b-30cf-843b-26283f6a5819",
          "cache-control": "no-cache, private",
          "accept-language": f"{country.lower()}_{country.upper()}",
          "accept-encoding": "gzip",
          "timezone": timezone_name,
          "accept": "*/*",
      }
      response = requests.get(url, headers=headers, params=querystring)
      
  
      result = response.json().get('carousel', {}).get('city', {})
      # Convert the average duration from milliseconds to minutes.
      result['averageDuration'] = round(result['averageDuration'] / 1000 / 60, 2)
      # Add the city name to the result
      result['location'] = location
          
      return result