MCP Soccer Data

🚀 サッカーデータ MCP サーバー

このサーバーは、Model Context Protocol (MCP) を基にしたオープンソースのサーバーです。SoccerDataAPI に接続し、最新のサッカー試合情報を提供し、自然言語によるデータクエリを可能にします。また、MCP 対応のクライアント（Claude Desktop など）と連携し、大規模言語モデル（LLMs）を通じてサッカーデータを取得できます。

✨ 主な機能

🏟️ リアルタイムのサッカー試合洞察

MCP-Soccerdata は、世界中で行われているサッカー試合のリアルタイム情報 を提供することに特化しています。

"現在、どのサッカー試合が行われていますか？"
"今日のパリサンジェルマン対アストンヴィラの予想スターティングラインナップを教えてください。"
"最近終了した試合のスコアと得点数を教えてください。"

これらの質問に対して、以下の詳細な分類で構造化された情報を提供します。

- 試合一覧と基本情報

• 世界中で開催されている全試合のリスト
• ホームチームとアウェイチームの名前
• 試合開始時間と日付
• 試合会場情報
• 現在のスコア

- 試合詳細

• 試合状態：予定、進行中、または終了
• 得点分解：前半、後半、延長戦、PK戦
• 最終結果：勝利、引き分け、または敗北

- 重要な試合イベント

• 得点状況（誰が得点したか、時間、方法）
• 選手交代状況
• イエローカードとレッドカード
• PK判罚

- チーム陣容

• スターティングXIの名簿
• 予備選手情報
• 怪我の状態
• 陣形配置

- オッズと賭け情報

• 勝、引き分け、敗のオッズ
• 得点数の上下限オッズ
• スコアのハンディキャップオッズ

- リーグメタデータ

• リーグ名
• 国名
• 競技形式（例：通常シーズン、決勝戦段階）

⚠️ 主に リアルタイム、これから行われる、および 最近終了した 試合に焦点を当てています。

🎥 デモ

🚀 クイックスタート

Smithery を通じたインストール

Smithery を通じて、Claude Desktop 用の Amadeus MCP サーバーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @yeonupark/mcp-soccer-data --client claude

前提条件

• Python 3.12 以上
• uv パッケージマネージャー
• Soccerdata API アカウント
• MCP 対応のクライアント（Claude Desktop など）

手動インストールガイド

1. リポジトリをクローンします。

   git clone https://github.com/yeonupark/mcp-soccer-data.git
   cd mcp-soccer-data
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. 環境変数を設定します。 .env ファイルを作成し、以下の内容を追加します。

   API_KEY=your_api_key_here
   

4. サーバーを起動します。

   python server.py
   

MCP クライアントの設定

1. クライアントの設定画面を開きます。
2. 以下の設定を追加します。
   • 名前：MCP-Soccerdata
   • タイプ：football_data
   • アドレス：http://localhost:5000

💻 使用例

基本的な使用法

print(get_livescores())

出力例：

[
  {
    "home_team": "Paris Saint-Germain",
    "away_team": "Marseille",
    "score": "2-1",
    "status": "finished"
  },
  {
    "home_team": "Bayern Munich",
    "away_team": "Borussia Dortmund",
    "score": "3-0",
    "status": "in_progress"
  }
]

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。