Cricket MCP Server

🚀 クリケットMCPサーバー

Cricbuzzから包括的なクリケットデータを提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、リアルタイムのクリケット統計、選手情報、試合日程、およびニュース更新を提供します。

✨ 主な機能

• 選手統計：テスト試合、ODI、T20などの全ての形式での打撃と投球の記録を含む、詳細なクリケット選手の統計を取得できます。
• ライブ試合：現在進行中のクリケット試合を取得できます。
• 試合日程：今後のクリケット試合の日程を取得できます。
• クリケットニュース：最新のクリケットニュースと更新情報を取得できます。

📦 インストール

1. このリポジトリをクローンまたはダウンロードします。
2. 必要な依存関係をインストールします。

pip install -r requirements.txt

💻 使用例

Gradio Web UIデモ

GradioとGeminiによる会話型のウェブインターフェースを使用して、クリケットMCPサーバーと対話することができます。

1. Gemini APIキーを設定する

会話エージェントを使用するには、Google Gemini APIキーが必要です。それを環境変数として設定します。

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

2. Gradioデモを実行する

python cricket_gradio.py

これにより、ブラウザにウェブUIが起動し、クリケットアシスタントとチャットし、統計、ライブ試合、ニュースなどを問い合わせることができます。

💡 使用アドバイス

チャット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"）。指定しない場合は、全ての形式の統計を返します。

戻り値:

• 選手の基本情報（名前、国籍、役割、画像）
• 打撃と投球のICCランキング
• 詳細な打撃統計
• 詳細な投球統計

例:

# 選手の全ての統計を取得する
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 Searchを使用しています。ウェブサイトの利用規約に準拠し、責任を持って使用するようにしてください。

依存関係

• fastmcp：MCPサーバーフレームワーク
• requests：ウェブスクレイピング用のHTTPライブラリ
• beautifulsoup4：HTML解析ライブラリ
• lxml：XML/HTMLパーサー
• googlesearch-python：Google検索APIのラッパー

設定

サーバーはデフォルトでstdioトランスポートで実行されます。基本的な使用には追加の設定は必要ありません。

エラーハンドリング

サーバーには、以下の問題に対する包括的なエラーハンドリングが含まれています。

• ネットワーク接続問題
• 無効な選手名
• Cricbuzz上のデータ欠落
• 検索失敗

MCPディレクトリバッジ

あなたのサーバーがリストされて安全であることを示すために、このバッジをREADMEに追加します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

コントリビュート

問題や機能強化のリクエストを自由に提出してください！

免責事項

このツールは公開ウェブサイトからデータをスクレイピングします。著者は、ウェブサイトの利用規約の誤用や違反について責任を負いません。責任を持って使用し、適用される条件と規約に準拠するようにしてください。