⚽️ サッカーデータ MCP サーバー

鍛冶屋のバッジ

MCP-Soccerdata は、 SoccerDataAPI に接続して、自然言語による対話を通じて最新のサッカーの試合情報を提供するオープンソースのModel Context Protocol (MCP)サーバーです。
Claude Desktop などの MCP 対応クライアントで使用するために設計されており、ユーザーは大規模言語モデル (LLM) を活用してフットボールデータを取得できます。

✨ 特徴

🏟️ ライブサッカー試合インサイト

MCP-Soccerdata は**、世界中で進行中のサッカーの試合に関するリアルタイム情報を配信することに重点を置いています。**

「今、どんなサッカーの試合が行われていますか？」
「今日のPSG対アストン・ヴィラ戦の予想されるラインナップは何ですか？」
「最近のサッカーの試合のスコアとゴール数を教えてください。」

→ 以下に説明する詳細なカテゴリを含む、構造化された形式で関連するサッカーデータを提供します。

- 試合リストと基本情報

現在アクティブなすべての試合のグローバルリスト
ホームチームとアウェイチームの名前
キックオフ時間と試合日
スタジアムの詳細
現在のスコア

- 試合詳細

試合ステータス: 予定、進行中、終了
ゴールの内訳：前半、後半、延長戦、PK戦
最終結果：勝利、引き分け、または敗北

- 主な試合イベント

ゴールイベント（誰が、いつ、どのように得点したか）
交代
イエローカードとレッドカード
罰則

- チームラインナップ

先発メンバー
ベンチプレーヤー
負傷状況
チーム編成

- オッズと賭け情報

勝ち/引き分け/負けのオッズ
オーバー/アンダーオッズ
ハンディキャップ賭けのオッズ

- リーグメタデータ

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

⚠️ライブ、今後の試合、最近終了した試合のみに焦点を当てています

Related MCP server: HackathonWatch MCP Server

🎥 デモ

マクペラ (3) (1)

🚀 クイックスタート

Smithery経由でインストール

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

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

前提条件

Python 3.12以上
uvパッケージマネージャー
サッカーデータ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ファイルをご覧ください。
モデルコンテキストプロトコルで構築

MCP-Soccerdata