Cricket

A MCP server for fetching cricket data from Cricbuzz, including player statistics, live match scores, upcoming schedules, and the latest news.

python

10

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tarun7r-cricket-mcp-server": {
      "command": "python3",
      "args": [
        "cricket_server.py"
      ]
    }
  }
}

You can run a Python-based MCP server that fetches cricket data from Cricbuzz, delivering real-time stats, live matches, schedules, news, and more to MCP clients. This guide shows you how to run the server locally, connect via MCP, and use its data endpoints effectively.

How to use

You will interact with the Cricket MCP Server through an MCP client. Start the server in stdio mode, then configure your client to communicate with the local Python process. Once running, you can request player statistics, live matches, schedules, news, ICC rankings, match scorecards, live commentary, and web search results. Each endpoint returns structured data you can render in your application or chat interface.

How to install

Prerequisites you need before starting:
- Python 3.8+ installed on your system
- pip available to install Python dependencies
- Git (optional, for cloning the project)

# Example install flow
# 1) Create a project directory and navigate into it
mkdir cricket-mcp
cd cricket-mcp

# 2) (Optional) Clone the MCP server repository
# git clone https://example.com/your/cricket-mcp-repo.git

# 3) Install dependencies
pip install -r requirements.txt

Configuration and running locally

The server runs as a local stdio MCP server. Use the following command configuration to run the server from your client setup.

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

Environment variables you need

To enable the Gradio/Gemini-powered conversational interface, set the Google Gemini API key in your environment.

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

Run the MCP server

Start the server by launching the Python script in your environment. The MCP config above will run the server in stdio transport.

python3 cricket_server.py

Available tools

get_player_stats

Fetch comprehensive cricket player statistics across formats, including basic info, ICC rankings for batting and bowling, and detailed batting and bowling records.

get_live_matches

Retrieve currently live cricket matches with participating teams and current status.

get_cricket_schedule

Fetch upcoming international cricket match schedules with dates and details.

get_cricket_news

Obtain the latest cricket news articles with headlines, descriptions, timestamps, and categories.

get_icc_rankings

Return official ICC rankings for batting, bowling, all-rounders, and teams across Test, ODI, and T20 formats.

get_match_details

Get a detailed scorecard for a specific match, including innings-by-innings batting and bowling statistics.

get_live_commentary

Provide recent live commentary for a given match URL with a limit on the number of lines.

web_search

Search the web for cricket topics and return results with titles, URLs, and snippets.

search_live_commentary

Search for live commentary updates for cricket matches by match description or team names.