Cricket MCP Server

🚀 板球MCP服務器

這是一個模型上下文協議（MCP）服務器，可從Cricbuzz獲取全面的板球數據。該服務器提供實時板球統計數據、球員信息、比賽日程和新聞更新。

✨ 主要特性

• 球員統計數據：獲取詳細的板球球員統計信息，包括所有比賽形式（測試賽、一日國際賽、T20賽）的擊球和投球記錄。
• 實時比賽：獲取當前正在進行的板球比賽信息。
• 比賽日程：獲取即將到來的板球比賽日程。
• 板球新聞：獲取最新的板球新聞和更新。

📦 安裝指南

1. 克隆或下載此倉庫。
2. 安裝所需的依賴項：

pip install -r requirements.txt

🚀 快速開始

演示：Gradio Web UI

你可以使用由Gradio和Gemini驅動的對話式Web界面與板球MCP服務器進行交互。

1. 設置你的Gemini API密鑰

你需要一個Google Gemini API密鑰才能使用對話代理。將其設置為環境變量：

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

2. 運行Gradio演示

python cricket_gradio.py

這將在你的瀏覽器中啟動一個Web UI，你可以在其中與板球助手聊天，詢問統計數據、實時比賽、新聞等信息。

💡 使用建議

聊天界面支持對話記憶和豐富的響應。

💻 使用示例

作為MCP服務器運行

該服務器可以與MCP客戶端集成。以下是配置方法：

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

為了更靈活的設置，你可以使用環境變量來定義Python可執行文件和服務器腳本的路徑。

獨立運行

出於測試目的，你可以直接運行服務器：

python cricket_server.py

可用工具

1. get_player_stats

獲取全面的板球球員統計信息。

參數：

• player_name (str)：板球球員的姓名
• match_format (str, 可選)：特定的比賽形式（"Test"、"ODI"、"T20"）。如果未提供，則返回所有比賽形式的統計信息。

返回值：

• 球員基本信息（姓名、國家、角色、圖片）
• 擊球和投球的國際板球理事會排名
• 詳細的擊球統計數據
• 詳細的投球統計數據

示例：

# 獲取一名球員的所有統計信息
stats = get_player_stats("Virat Kohli")

# 僅獲取T20比賽的統計信息
t20_stats = get_player_stats("Virat Kohli", "T20")

2. get_live_matches

獲取當前正在進行的板球比賽信息。

返回值： 包含比賽隊伍和當前狀態的實時比賽信息列表。

3. get_cricket_schedule

獲取即將到來的板球比賽日程。

返回值： 包含日期和詳細信息的即將到來的國際板球比賽列表。

4. get_cricket_news

獲取最新的板球新聞。

返回值： 包含標題、描述、時間戳和類別的板球新聞文章列表。

🔧 技術細節

數據源

該服務器從Cricbuzz.com抓取數據，並使用Google搜索來發現球員資料。請確保你遵守該網站的服務條款並負責任地使用。

依賴項

• fastmcp：MCP服務器框架
• requests：用於網頁抓取的HTTP庫
• beautifulsoup4：HTML解析庫
• lxml：XML/HTML解析器
• googlesearch-python：Google搜索API包裝器

配置

服務器默認使用stdio傳輸。基本使用無需額外配置。

錯誤處理

服務器包含全面的錯誤處理機制，可處理以下情況：

• 網絡連接問題
• 無效的球員姓名
• Cricbuzz上缺少數據
• 搜索失敗

MCP目錄徽章

將此徽章添加到你的README中，以表明你的服務器已列出且安全：

📄 許可證

本項目採用MIT許可證。有關詳細信息，請參閱LICENSE文件。

貢獻

歡迎提交問題和改進請求！

免責聲明

此工具從公共網站抓取數據。作者不對任何濫用或違反網站服務條款的行為負責。請負責任地使用，並確保遵守適用的條款和條件。