cricket

This MCP server exposes a comprehensive Cricket data toolkit powered by Cricbuzz data and Google-powered discovery. It includes tools to fetch player statistics, live matches, schedules, cricket news, official ICC rankings, detailed match scorecards, live commentary, and web search results related to cricket topics. You can interact with these capabilities through MCP clients by invoking the provided functions (e.g., get_player_stats, get_live_matches, get_cricket_schedule, get_cricket_news, get_icc_rankings, get_match_details, get_live_commentary, web_search, and search_live_commentary). For development or testing, you can also run the standalone server or use the included Gradio-based conversational UI (Gradio interacts with the same underlying MCP endpoints). To enable the Gemini-powered conversational assistant, set your Google Gemini API key in the GOOGLE_API_KEY environment variable before starting the server or UI.

Prerequisites:

• Python 3.8+ installed on your system
• pip (Python package manager)
• Internet access to install dependencies

Steps:

1. Clone or download the repository
2. Navigate to the project directory
3. Install dependencies:

pip install -r requirements.txt

4. (Optional) Set your Gemini API key for the Gradio UI or conversational agent:

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

5. Run the MCP server:

python3 cricket_server.py

6. If you want to use the Gradio web UI for conversational interaction:

python3 cricket_gradio.py

Notes:

• The server runs on stdio transport by default as shown in the MCP configuration. Adjust as needed for your environment.
• Ensure you comply with Cricbuzz terms of service and Google’s terms for the Gemini API when using the data and AI capabilities.

Tips and considerations:

• Environment variable GOOGLE_API_KEY is required to power the Gradio conversational UI paired with Gemini; set it prior to launching the UI.
• This MCP server scrapes data from Cricbuzz; ensure usage complies with Cricbuzz terms and robots.txt restrictions.
• If you encounter network or data-missing issues, verify your network connectivity and the validity of the target Cricbuzz pages referenced by the tools.
• The available tools cover a broad range of cricket data: live matches, schedules, player stats (with optional format filtering), ICC rankings, match scorecards, and live commentary, as well as generic web search for cricket topics.
• When deploying in production, consider configuring transport and environment variables to suit your security and hosting requirements.
• The Gradio demo requires a Google Gemini API key; without it, the conversational UI may be limited.