Cricket MCP Server

A Model Context Protocol (MCP) server that provides comprehensive cricket data from Cricbuzz. This server offers real-time cricket statistics, player information, match schedules, and news updates.

Features

• Player Statistics: Get detailed cricket player stats including batting and bowling records across all formats (Test, ODI, T20)
• Live Matches: Fetch currently ongoing cricket matches
• Match Schedule: Get upcoming cricket match schedules
• Cricket News: Latest cricket news and updates
• ICC Rankings: Official ICC rankings for batting, bowling, all-rounders, and teams across Test, ODI, and T20 formats
• Match Scorecards: Detailed match analysis with batting and bowling statistics
• Live Commentary: Recent ball-by-ball updates for a given match URL
• Web Search: Internet search with titles/snippets for cricket topics

Installation

1. Clone or download this repository
2. Install the required dependencies:

pip install -r requirements.txt

Demo: Gradio Web UI

You can interact with the Cricket MCP Server using a conversational web interface powered by Gradio and Gemini.

1. Set your Gemini API key

You need a Google Gemini API key to use the conversational agent. Set it as an environment variable:

export GOOGLE_API_KEY="your-gemini-api-key"

2. Run the Gradio demo

python3 cricket_gradio.py

This will launch a web UI in your browser where you can chat with the cricket assistant, ask for stats, live matches, news, and more.

Tip: The chat UI supports conversation memory and rich responses.

Usage

Running as an MCP Server

The server can be integrated with MCP clients. Here's how to configure it:

    {
        "cricket": {
            "command": "python3",
            "args": ["cricket_server.py"],
            "transport": "stdio",
        }
    }

For a more flexible setup, you can use environment variables to define the python executable and server script path.

Running Standalone

For testing purposes, you can run the server directly:

python3 cricket_server.py

Available Tools

1. get_player_stats

Get comprehensive cricket player statistics.

Parameters:

• player_name (str): Name of the cricket player
• match_format (str, optional): Specific format ("Test", "ODI", "T20"). If not provided, returns all formats.

Returns:

• Player basic info (name, country, role, image)
• ICC rankings for batting and bowling
• Detailed batting statistics
• Detailed bowling statistics

Example:

# Get all stats for a player
stats = get_player_stats("Virat Kohli")

# Get only T20 stats
t20_stats = get_player_stats("Virat Kohli", "T20")

2. get_live_matches

Get currently live cricket matches.

Returns: List of live match information including teams and current status.

3. get_cricket_schedule

Get upcoming cricket match schedule.

Returns: List of upcoming international cricket matches with dates and details.

4. get_cricket_news

Get the latest cricket news.

Returns: List of cricket news articles with headlines, descriptions, timestamps, and categories.

5. get_icc_rankings

Get official ICC cricket rankings for various categories.

Parameters:

• category (str): The ranking category. Must be one of: "batting", "bowling", "all-rounder", or "teams".

Returns: 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.

Example:

# Get batting rankings
batting_rankings = get_icc_rankings("batting")

# Get bowling rankings
bowling_rankings = get_icc_rankings("bowling")

# Get team rankings
team_rankings = get_icc_rankings("teams")

6. get_match_details

Get detailed scorecard for a specific cricket match.

Parameters:

• match_url (str): The URL of the match on Cricbuzz (can be o

... View full README on GitHub