cricket-mcp-server

Instructions

Implementation Reference

• cricket_server.py:225-327 (handler)

  The handler function for the 'get_match_details' tool. It scrapes the Cricbuzz match page for title, result, and detailed scorecard including batting and bowling stats for each innings. Registered via @mcp.tool() decorator.
  @mcp.tool() def get_match_details(match_url: str) -> dict: """ Get detailed scorecard for a specific cricket match from a Cricbuzz URL. Args: match_url (str): The URL of the match on Cricbuzz (can be obtained from get_live_matches). Returns: dict: A dictionary containing match details including: - Match title and result. - A scorecard for each innings with batting and bowling stats. """ if not match_url or "cricbuzz.com" not in match_url: return {"error": "A valid Cricbuzz match URL is required."} try: response = requests.get(match_url, headers=HEADERS, timeout=10) response.raise_for_status() source = response.text page = BeautifulSoup(source, "lxml") except requests.exceptions.ConnectionError as e: return {"error": f"Connection error: {str(e)}"} except requests.exceptions.Timeout as e: return {"error": f"Request timeout: {str(e)}"} except requests.exceptions.HTTPError as e: return {"error": f"HTTP error: {str(e)}"} except Exception as e: return {"error": f"Failed to fetch or parse match page: {str(e)}"} match_data = {} # Extract title and result title_tag = page.find("h1", class_="cb-nav-hdr") if title_tag: match_data["title"] = title_tag.text.strip() result_tag = page.find("div", class_="cb-nav-text") if result_tag: match_data["result"] = result_tag.text.strip() # Scorecard scorecard = {} innings_divs = page.find_all("div", id=re.compile(r"^inning_\d+$")) for i, inning_div in enumerate(innings_divs): inning_key = f"inning_{i+1}" inning_data = {"batting": [], "bowling": []} inning_title_tag = inning_div.find("div", class_="cb-scrd-hdr-rw") if inning_title_tag: inning_data["title"] = inning_title_tag.text.strip() # Batting stats batsmen = inning_div.find_all("div", class_=lambda x: x and x.startswith('cb-col cb-col-w-')) for batsman in batsmen: cols = batsman.find_all("div", class_=lambda x: x and x.startswith('cb-col cb-col-w-')) if len(cols) > 1 and "batsman" in cols[0].text.lower(): # Header row continue if len(cols) >= 7: player_name = cols[0].text.strip() if "Extras" in player_name or not player_name: continue inning_data["batting"].append({ "player": player_name, "dismissal": cols[1].text.strip(), "R": cols[2].text.strip(), "B": cols[3].text.strip(), "4s": cols[4].text.strip(), "6s": cols[5].text.strip(), "SR": cols[6].text.strip(), }) # Bowling stats bowlers_section = inning_div.find("div", class_="cb-col-bowlers") if bowlers_section: bowlers = bowlers_section.find_all("div", class_="cb-scrd-itms") for bowler in bowlers: cols = bowler.find_all("div", class_=lambda x: x and x.startswith('cb-col cb-col-w-')) if len(cols) > 1 and "bowler" in cols[0].text.lower(): # Header row continue if len(cols) >= 6: player_name = cols[0].text.strip() if not player_name: continue inning_data["bowling"].append({ "player": player_name, "O": cols[1].text.strip(), "M": cols[2].text.strip(), "R": cols[3].text.strip(), "W": cols[4].text.strip(), "Econ": cols[5].text.strip(), }) scorecard[inning_key] = inning_data match_data["scorecard"] = scorecard return match_data
• cricket_server.py:225-225 (registration)

  The @mcp.tool() decorator registers the get_match_details function as an MCP tool in FastMCP.
  @mcp.tool()
• cricket_server.py:226-237 (schema)

  Type hints and docstring define the input schema (match_url: str) and output format (dict with title, result, scorecard).
  def get_match_details(match_url: str) -> dict: """ Get detailed scorecard for a specific cricket match from a Cricbuzz URL. Args: match_url (str): The URL of the match on Cricbuzz (can be obtained from get_live_matches). Returns: dict: A dictionary containing match details including: - Match title and result. - A scorecard for each innings with batting and bowling stats. """