cricket-mcp-server

Instructions

Implementation Reference

• cricket_server.py:433-533 (handler)

  The handler function implementing the get_icc_rankings tool. It scrapes ICC rankings from Cricbuzz for categories like batting, bowling, all-rounder, or teams across Test, ODI, and T20 formats. The @mcp.tool() decorator handles automatic registration and schema generation from the docstring.
  @mcp.tool() def get_icc_rankings(category: str) -> dict: """ Fetches official ICC cricket rankings for various categories. Use this tool to answer questions about top players and teams in Test, ODI, and T20 formats. For example, you can answer questions like: - "Who are the top 10 ODI batsmen?" - "Show me the test bowling rankings." - "What are the T20 team rankings?" - "icc ranking odi batsman" Args: category (str): The ranking category. Must be one of: "batting", "bowling", "all-rounder", or "teams". Returns: dict: A dictionary with rankings for Test, ODI, and T20 formats. Each format contains a list of players or teams with their position, name, country, and rating. """ if category not in ["batting", "bowling", "all-rounder", "teams"]: return {"error": "Invalid category. Choose from 'batting', 'bowling', 'all-rounder', 'teams'."} # The 'all-rounder' category is spelled as 'all-rounder' in the URL url_category = category if category != "all-rounder" else "all-rounder" link = f"https://www.cricbuzz.com/cricket-stats/icc-rankings/men/{url_category}" try: response = requests.get(link, headers=HEADERS, timeout=10) response.raise_for_status() source = response.text page = BeautifulSoup(source, "lxml") rankings = {} # Define formats to scrape formats = ["test", "odi", "t20"] # Map category to the format used in ng-show directive category_map = { "batting": "batsmen", "bowling": "bowlers", "all-rounder": "allrounders", "teams": "teams" } angular_category = category_map.get(category) for f in formats: format_key = f"{angular_category}-{f}s" # e.g., batsmen-tests if f == 't20': format_key = f"{angular_category}-t20s" # Find the container for the specific format format_container = page.find("div", {"ng-show": f"'{format_key}' == act_rank_format"}) if not format_container: continue ranking_list = [] if category == "teams": # Find all team rows rows = format_container.find_all("div", class_="cb-col cb-col-100 cb-font-14 cb-brdr-thin-btm text-center") for row in rows: position = row.find("div", class_="cb-col cb-col-20 cb-lst-itm-sm").text.strip() team_name = row.find("div", class_="cb-col cb-col-50 cb-lst-itm-sm text-left").text.strip() rating = row.find_all("div", class_="cb-col cb-col-14 cb-lst-itm-sm")[0].text.strip() points = row.find_all("div", class_="cb-col cb-col-14 cb-lst-itm-sm")[1].text.strip() ranking_list.append({ "position": position, "team": team_name, "rating": rating, "points": points }) else: # Find all player rows rows = format_container.find_all("div", class_="cb-col cb-col-100 cb-font-14 cb-lst-itm text-center") for row in rows: position = row.find("div", class_="cb-col cb-col-16 cb-rank-tbl cb-font-16").text.strip() rating = row.find("div", class_="cb-col cb-col-17 cb-rank-tbl pull-right").text.strip() player_info = row.find("div", class_="cb-col cb-col-67 cb-rank-plyr") player_name = player_info.find("a").text.strip() country = player_info.find("div", class_="cb-font-12 text-gray").text.strip() ranking_list.append({ "position": position, "player": player_name, "country": country, "rating": rating }) rankings[f] = ranking_list return rankings except requests.exceptions.RequestException as e: return {"error": f"Request failed: {str(e)}"} except Exception as e: return {"error": f"An error occurred: {str(e)}"}