Used for player profile discovery through Google Search, enabling the MCP server to find and retrieve cricket player information when specific player URLs are not directly known.
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
Installation
- Clone or download this repository
- Install the required dependencies:
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:
2. Run the Gradio demo
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:
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:
Available Tools
1. get_player_stats
Get comprehensive cricket player statistics.
Parameters:
player_name
(str): Name of the cricket playermatch_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:
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.
Data Source
This server scrapes data from Cricbuzz.com and uses Google Search for player profile discovery. Please ensure you comply with the website's terms of service and use responsibly.
Dependencies
fastmcp
: MCP server frameworkrequests
: HTTP library for web scrapingbeautifulsoup4
: HTML parsing librarylxml
: XML/HTML parsergooglesearch-python
: Google search API wrapper
Configuration
The server runs on stdio transport by default. No additional configuration is required for basic usage.
Error Handling
The server includes comprehensive error handling for:
- Network connectivity issues
- Invalid player names
- Missing data on Cricbuzz
- Search failures
MCP Directory Badge
Add this badge to your README to show your server is listed and safe:
License
This project is licensed under the MIT License. See the LICENSE file for details.
Contributing
Feel free to submit issues and enhancement requests!
Disclaimer
This tool scrapes data from public websites. The authors are not responsible for any misuse or violation of website terms of service. Use responsibly and ensure compliance with applicable terms and conditions.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An MCP server for fetching cricket data from Cricbuzz, including player statistics, live match scores, upcoming schedules, and the latest news.
Related MCP Servers
- AsecurityAlicenseAqualityMCP Server enabling integration with Scrapezy to retrieve structured data from websites.Last updated -1121JavaScriptMIT License
- -securityAlicense-qualityA comprehensive MCP server providing detailed IMDb data including movies, TV shows, and upcoming releases.Last updated -2PythonMIT License
- -securityFlicense-qualityMCP server for the Clash of Clans API. Can get player, clan information, analyze ongoing wars, as well as war logs (provided they are public).Last updated -3JavaScript
- -securityFlicense-qualityAn MCP Server that enables interaction with MLB scores and statistics via the SportsData.io MLB V3 Scores API, allowing users to access baseball data through natural language queries.Last updated -Python