Soccer MCP Server

サッカーMCPサーバー

API-Football サービスを使用して、サッカーの統計とライブ試合データ用のモデル コンテキスト プロトコル (MCP) を実装する Python サーバー。

概要

このサーバーは、API-Football APIを通じてサッカーデータにアクセスするための包括的なツールセットを提供します。アプリケーションとサッカーデータサービス間の橋渡しとして機能し、世界中のリーグ、チーム、選手のライブ試合情報と過去の統計情報を提供します。

特徴

• リーグデータ（順位、試合日程、スケジュール）
• チーム情報と試合日程
• 選手の統計とプロフィール
• ライブ試合データ（イベント、統計、タイムライン）
• 試合分析（統計、イベント）

構成

このサーバーには、API-Football サービス用の RapidAPI からの API キーが必要です。

1. RapidAPIでアカウントを作成する
2. API-Football APIを購読する
3. 環境変数を設定します。
   RAPID_API_KEY_FOOTBALL=your_api_key_here

ツール

リーグデータ

• 名前でリーグIDを取得する
  • 指定されたリーグ名のリーグIDを取得します
  • 例: get_league_id_by_name(league_name="Premier League")
• すべてのリーグIDを取得する
  • IDを持つすべてのサッカーリーグのリストを取得します
  • 国別にフィルタリングできます
  • 例: get_all_leagues_id(country=["England", "Spain"])
• 順位を取得する
  • 複数のリーグとシーズンのリーグ順位を取得します
  • チーム別にフィルタリング可能
  • 例: get_standings(league_id=[39, 140], season=[2022, 2023])
• リーグ情報を取得する
  • 特定のサッカーリーグに関する情報を取得する
  • 例: get_league_info(league_name="Champions League")
• リーグ試合情報を取得する
  • 指定されたリーグとシーズンのすべての試合日程を取得します
  • 例: get_league_fixtures(league_id=39, season=2023)
• 日付別にリーグスケジュールを取得する
  • 指定した日付のリーグのスケジュールを取得します
  • 例: get_league_schedule_by_date(league_name="Premier League", date=["2024-03-08", "2024-03-09"], season="2023")

プレイヤーデータ

• プレイヤーIDを取得する
  • 名前に一致するプレーヤーのプレーヤーIDと情報を取得します
  • 例: get_player_id(player_name="Messi")
• プレイヤープロフィールを取得する
  • プレイヤーのプロフィールを姓で取得する
  • 例: get_player_profile(player_name="Messi")
• プレイヤー統計情報を取得する
  • シーズンとリーグ名別に詳細な選手統計情報を取得します
  • 例: get_player_statistics(player_id=154, seasons=[2022, 2023], league_name="La Liga")
• プレイヤー統計情報を取得する
  • シーズンとリーグID別に詳細な選手統計情報を取得します
  • 例: get_player_statistics_2(player_id=154, seasons=[2022, 2023], league_id=140)

チームデータ

• チームの試合情報を取得する
  • チームの過去または今後の試合日程を返します
  • 例: get_team_fixtures(team_name="Manchester United", type="past", limit=3)
• 日付範囲別にチームフィクスチャーを取得する
  • 日付範囲内のチームの試合予定を取得する
  • 例: get_team_fixtures_by_date_range(team_name="Liverpool", from_date="2023-09-01", to_date="2023-09-30", season="2023")
• チーム情報を取得する
  • 特定のチームに関する基本情報を取得する
  • 例: get_team_info(team_name="Real Madrid")

試合/試合日程データ

• get_fixture_statistics
  • 特定のフィクスチャの詳細な統計情報を取得します
  • 例: get_fixture_statistics(fixture_id=867946)
• get_fixture_events
  • 試合中のすべてのイベント（ゴール、カード、交代）を取得します
  • 例: get_fixture_events(fixture_id=867946)
• 複数のフィクスチャの統計情報を取得する
  • 複数の試合の統計情報を一度に取得します
  • 例: get_multiple_fixtures_stats(fixture_ids=[867946, 867947, 867948])

ライブマッチデータ

• チームのライブマッチを取得する
  • チームが現在ライブでプレイしているかどうかを確認します
  • 例: get_live_match_for_team(team_name="Chelsea")
• チームのライブ統計を取得する
  • 試合中のチームのライブゲーム内統計を取得します
  • 例: get_live_stats_for_team(team_name="Liverpool")
• ライブマッチタイムラインを取得する
  • チームのライブ試合のイベントのタイムラインをリアルタイムで取得します
  • 例: get_live_match_timeline(team_name="Manchester City")

使用法

サーバーは Fast MCP フレームワークを使用して実装され、スタンドアロン サービスとして実行できます。

構成

• より信頼性の高い動作のために、サーバーは30秒のタイムアウトで実行されます。
• 正常なシャットダウンのためにシグナルハンドラが実装されています（Ctrl+C）

Claude Desktopでの使用

オプション 1: Docker を使用する (推奨)

1. このリポジトリをクローンする

2. 依存関係をインストールする

3. Dockerイメージをビルドする

4. Dockerコンテナを実行します（APIキーが環境変数として渡されていることを確認してください）

5. これをclaude_desktop_config.jsonに追加します:

オプション2: Pythonの直接実行

1. このリポジトリをクローンする

2. 依存関係をインストールする

3. APIキー環境変数を設定する

4. 必要に応じて Python パスを調整しながら、これをclaude_desktop_config.jsonに追加します。

選択した設定を追加したら、Claude Desktop を再起動してサッカーサーバーをロードしてください。これで、Claude との会話ですべてのサッカーデータツールを使用できるようになります。

技術的な詳細

サーバーは以下に基づいて構築されています:

• API-Football（RapidAPI経由）
• APIインターフェース用のMCP
• 入力検証のためのPydantic
• API通信のリクエスト

ライセンス

この MCP サーバーは MIT ライセンスの下で利用できます。