openfoot-mcp

openfoot-mcp

OpenFootAPI のサッカーインテリジェンス API 用 MCP サーバーです。LLM クライアントに、架空のスコアではなく、試合日程、順位表、ラインナップ、ライブイベント、ピッチ座標付きのシュート単位の xG、モデルから算出したフェアオッズなどの実際のサッカーデータを提供します。

15 個のツールと 1 つのプロンプトを備えています。Node ≥ 20。ビルド手順は不要です。

インストール

npx openfoot-mcp

環境変数に API キーを設定します。無料プランは月 5,000 リクエストです。openfootapi.com/pricing でキーを取得してください。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "openfoot": {
      "command": "npx",
      "args": ["-y", "openfoot-mcp"],
      "env": { "OPENFOOT_API_KEY": "of_live_..." }
    }
  }
}

Cursor / Windsurf / 任意の stdio MCP クライアント

同じブロックを、そのクライアントの MCP 設定ファイルに記述します。

ツール

ツール	返される内容
openfoot_competitions	対応する大会、シーズンのメタデータ、大会ごとのデータソースとライセンス
openfoot_search	チーム名または大会名のフリーテキスト検索 → 安定した ID
openfoot_matches	日付／大会／チーム／ステータス／シーズン／ラウンドで絞り込んだ試合日程と結果。カーソル方式のページネーションに対応
openfoot_standings	大会とシーズンの順位表
openfoot_match_lineups	先発 XI、ベンチ、フォーメーション
openfoot_match_events	ゴール、カード、交代、実況タイムライン
openfoot_match_xg	シュートごとに 1 件のエントリー：ピッチ座標と xG 値
openfoot_match_context	派生コンテキスト — チームの調子、直接対決、事前計算済みシグナル
openfoot_league_xg	リーグの xG 表：xG の得点と被得点、実際のゴール数に対する実績の上振れ／下振れ
openfoot_odds	ブックメーカーのベンチマークと、暗黙的に算出したフェア確率。情報提供を目的としており、賭けの助言ではありません
openfoot_quota	月間残りクォータ — この呼び出しではクォータを消費しません
openfoot_health	接続確認。API キーなしで利用できます

プロンプト：scout_team_form — チームを特定し、直近 5 試合を取得して、結果の背景にある xG を確認します。

ID の特定には openfoot_search から始めてください。ID を推測するとクォータを無駄にします。404 や空の結果も、ほかのリクエストと同様に計測対象です。

対応範囲について

カタログには 120 の大会が掲載されています。対応の深さは一様ではなく、カタログの範囲は深い対応範囲より広くなっています。

• 最も深く対応： Bundesliga、2. Bundesliga、DFB Pokal、Superliga României
• ヨーロッパで対応を拡大中： Eredivisie、Primeira Liga、Süper Lig、Pro League、Scottish Premiership
• 過去データ／分析のみ： Premier League、La Liga、Serie A、Ligue 1（xG は Understat 由来）

openfoot_competitions を呼び出し、利用するリーグを確認してから、それを前提とした開発を行ってください。

クォータの動作

• 無料プラン：月 5,000 リクエスト、60 req/min。Developer は月 $14：月 250,000 リクエスト、100 req/min。xG、シュートマップ、ラインナップ、ライブイベント、フェアオッズを含みます。Pro は $39：月 2,000,000 リクエスト、250 req/min。
• 超過分の請求はありません。 クォータを使い切ると API は 429 を返します。このサーバーはそれを空の結果ではなく、quota_or_rate_limit エラーとして通知します。
• クォータは毎月 1 日の UTC にリセットされます。
• 404 や空の結果を含む、すべてのリクエストが計測対象です。

このツールが適さないケース

• 複数の大会を対象にした高頻度のライブポーリング。 月間クォータはこの用途に適していません。他社の 1 日単位または 1 秒単位のプランのほうが安く済みます。
• 上記の深い対応範囲に含まれないリーグ。
• 契約上の SLA、稼働率に応じたクレジット、または担当者のいるサポート窓口が必要な場合。 この価格では提供していません。

開発

npm install
npm run smoke   # boots the server over stdio, lists tools, calls health

npm run smoke は API キーなしで動作します。openfoot_health はライブステータスを返し、API キーが必要なツールは内容のわかる missing_api_key エラーを返します。これにより、「未設定」と「故障」を区別できます。

MIT。