⚽️ Soccerdata MCP Server

⚽️ Soccerdata MCP サーバー

• MCP-Soccerdata は、自然言語でのやり取りを通じて最新のサッカー試合情報を提供するために、SoccerDataAPI に接続するオープンソースの Model Context Protocol (MCP) サーバーです。

• Claude Desktop などの MCP 対応クライアントでの利用を想定して設計されており、LLM を活用してサッカーデータを取得できます。

---

✨ 機能

🏟️ ライブサッカー試合情報

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

「現在、どのサッカーの試合が行われていますか？」
「今日の PSG 対 Aston Villa の予想先発メンバーは？」
「最近のサッカーの試合のスコアとゴール数を教えてください。」

→ 以下に詳しく記載したカテゴリを含む、関連するサッカーデータを構造化形式で提供します。

- 試合一覧と基本情報

• 現在開催中の全試合の一覧
• ホームチームとアウェイチームの名前
• キックオフ時刻と試合日
• スタジアムの詳細
• 現在のスコア

- 試合の詳細

• 試合状況：予定、進行中、終了
• ゴールの内訳：前半、後半、延長戦、PK戦
• 最終結果：勝利、引き分け、敗北

- 主な試合イベント

• ゴールイベント（得点者、時間、方法）
• 選手交代
• イエローカードとレッドカード
• PK

- チームのラインアップ

• 先発メンバー
• ベンチ入り選手
• 負傷状況
• チームのフォーメーション

- オッズと賭けに関する情報

• 勝利／引き分け／敗北のオッズ
• オーバー／アンダーのオッズ
• ハンディキャップ賭けのオッズ

- リーグのメタデータ

• リーグ名
• 国
• 大会形式（例：レギュラーシーズン、ノックアウトステージ）

⚠️ ライブ中、開催予定、最近終了した試合のみに特化しています

---

🎥 デモ

---

🚀 クイックスタート

Smithery 経由でインストール

Smithery 経由で、Claude Desktop 向けの Amadeus MCP Server を自動的にインストールするには：

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

前提条件

• Python 3.12+
• uv パッケージマネージャー
• Soccerdata API アカウント
• MCP 対応クライアント（例：Claude for Desktop）

1. クローンとセットアップ

• リポジトリをクローンします

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

• 依存関係をインストールします

uv sync

2. API キーを取得して環境を設定

• 認証情報を記載した .env ファイルを作成します：

AUTH_KEY=your_auth_key

https://soccerdataapi.com/ で登録し、ご自身の認証キーを取得してください。

3. MCP クライアントを設定

• このサーバーを MCP クライアント（例：Claude for Desktop）に登録します。

~/Library/Application Support/Claude/claude_desktop_config.json: を編集します

{
  "mcpServers": {
      "mcp-soccer-data": {
          "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
          "args": [
              "--directory",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
              "run",
              "--env-file",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
              "server.py"
          ]
      }
  }
}

---

🛠️ ツール

以下のツールが MCP クライアントに公開されています：

get_livescores()

-> 世界中で開催中のサッカー試合に関するリアルタイム情報を返します。

---

📝 ライセンス

• このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。
• Model Context Protocol を使用して構築されています