footballcharts-mcp

Football Charts のフットボールデータ MCP サーバー — 下部ディビジョンを含む 98 リーグ

英語 · 简体中文 (簡体字中国語)

44 か国にまたがる98 リーグのフットボールデータを AI アシスタントに提供します。ほかのソースでは省かれる下部ディビジョンも対象です。順位表、試合結果、試合日程、得点時間帯、公開ベースラインモデル、モンテカルロ法によるシーズン予測を football-charts.comから取得できます。

FC が公開するのは確率と公開済みのキャリブレーション記録であり、賭けの助言ではありません。 すべてのモデル確率はキックオフ前に公開され、試合後に採点されます。 get_track_record ツールは、その記録（的中率、Brier スコア、信頼性の区分）を返します。

API キーは不要です

すべてのツールは API キーなしで、IP あたり 1 日 100 リクエスト（1 分あたり 20 回）まで利用できます。 無料キーを取得すると、個人利用に限り上限が1 日 200 回、1 分あたり 60 回に増えます（同じメールアドレスに紐づくキーはすべて合算されます）。数秒で取得できます。

curl -X POST https://footballcharts-backend.onrender.com/api/v1/keys/register/ \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]"}'

キー（fc_...）は一度だけ表示されるため、保存してください。どちらの利用枠でも、98 リーグすべて（トップディビジョンと下部ディビジョン、女子リーグ）、現シーズンと前シーズン、モデル確率、毎日実行される 10,000 回のモンテカルロ予測を利用できます。賭けオッズは含まれません（過去のオッズアーカイブは、football-charts.com/dataで提供する有料データセットです）。

claude.ai（ウェブまたはモバイル）で利用する — インストール不要

設定 → コネクター → カスタムコネクターを追加を選択し、次を貼り付けます。

https://mcp.football-charts.com/mcp

これがキー不要の利用枠です。キーを使う場合は、代わりに https://mcp.football-charts.com/fc_your_key_here/mcpを貼り付けます（コネクターの入力欄には URL しか指定できないため、キーは URL に含まれます。キーは読み取り専用で、無料で、いつでも差し替えられます）。ヘッダーを送信できるクライアントでは、 POST https://mcp.football-charts.com/mcpにAuthorization: Bearer fc_…を指定します。

Claude Desktop で利用する — ワンクリック拡張機能

最新リリースからfootballcharts-mcp-<version>.mcpbをダウンロードして開くと、Claude Desktop がインストールします。API キー欄は空のままで構いません。

Claude Desktop で利用する — 手動設定

claude_desktop_config.json（FC_API_KEYは 0.4.0 以降、省略可能です）：

{
  "mcpServers": {
    "football-charts": {
      "command": "npx",
      "args": ["-y", "footballcharts-mcp"],
      "env": { "FC_API_KEY": "fc_your_key_here" }
    }
  }
}

Claude Code で利用する

claude mcp add football-charts -e FC_API_KEY=fc_your_key_here -- npx -y footballcharts-mcp

ツール

読み取り専用ツールは10種類あります。各ツールの説明には、返される内容が記載されています。

ツール	用途
about_football_charts	データソースの概要：対象リーグ、保持していない情報、リーグキーとシーズンの形式、確率の読み方。
list_leagues	対象となるすべてのリーグ（44か国にわたる98リーグ）と、それぞれのキー、国、利用可能なシーズン。
get_league_table	1つのリーグのシーズン順位表。調子、期待勝ち点、運のカテゴリを含みます。別の順位で見るには view=luck または goals を指定します。
get_results	1つのリーグのシーズンで終了した試合。フルタイムとハーフタイムのスコア、先制点の時間を含みます。team で絞り込み、last で最新のN件を保持します。
get_fixtures	モデルの較正済み確率を含む、1つのリーグの今後の試合。
get_match	スラッグで指定した1試合の詳細。モデルの確率、チーム評価、得点時間帯のヒストグラムを含みます。
get_season_projection	1万回のシミュレーションに基づく優勝、トップ4、下位3チームの確率と勝ち点の範囲。毎日更新されます。
get_team	1チームのシーズン情報：順位表の行、試合ログ、15分ごとの得点数、先制点の分布。
get_goal_timing	リーグのシーズンにおける全チームの15分ごとの得点数、ピーク時間帯、リーグ合計。1チームの場合は team を指定します。
get_track_record	モデルの公開較正記録：的中率、Brierスコア、信頼性区分。

このモデルは公開ベースライン（Dixon-Coles）です。較正済みであり、get_track_record で性能を確認できますが、ブックメーカー市場を上回るものではありません。91リーグを対象とした2020年以降のブックメーカー別の開始オッズと終了オッズは、有料データセットとして football-charts.com/data で提供されています。

変更履歴

• 0.6.0 — すべての回答に、同じデータを掲載した football-charts.com のページへのリンク（source_url）を追加しました。get_track_record が較正記録（的中率、Brierスコア、信頼性区分）を返すようになりました。説明には、モデルへの指示を含めず、各ツールが返す内容を記載しました。各ツールのタイトルも annotations.title に追加しました。出力からサイト専用フィールド roi_*、profit_*、gates を削除しました。get_season_projection は投影データがない場合、出力の検証に失敗するのではなく、その旨を説明するようになりました。ツールと引数は10種類のままです。
• 0.5.0 — すべてのツールに outputSchema を追加し、structuredContent を返すようになりました。説明を利用者の視点から書き直しました（目的 → 代わりに使う関連ツール → 例）。get_match からストレージ内部情報を削除しました。ツール一覧は約6kトークンです（以前は約3k）。この増加はスキーマによるものです。意図的に選択した点が2つあります。list_leagues は1件の取得ではなく全件を列挙するため、list_ 接頭辞を維持しています。また、league は93個のキーを列挙するのではなく、自由形式の文字列のままにしています（列挙型にすると各ツールに約700トークン追加されます。list_leagues を使えば1回の呼び出しで名前を解決できます）。スキーマの末端は型指定なしにしているため、想定外の null が呼び出しを失敗させることはありません。フィールドの型はAPIの返却内容に合わせています（件数と確率は数値、日付はISO形式、スコアは 'home:away' 形式の文字列）。
• 0.4.1 — レジストリエントリでホスト済みエンドポイント（remotes）を宣言し、コネクターディレクトリに掲載されるようになりました。get_results の並び順の説明を明確化しました（時系列順、last=N は最新のN件を保持）。
• 0.4.0 — APIキーは任意になりました。APIはキーなしの呼び出しをIPごとに1日300回（1分あたり20回）受け付け、429エラーで無料キーの取得方法を案内します。about と list_leagues の説明を更新しました。MCPB デスクトップ拡張バンドル（manifest.json、アイコン）を追加しました。レジストリで FC_API_KEY の isRequired: false を設定しました。
• 0.3.0 — モデル向けに説明を書き直しました（使用場面／返される内容／例）。概要を示す新しい about_football_charts ツールを追加しました（キー不要）。get_rankings を view を使って get_league_table に統合しました。get_goal_timing に team フィルターと peak_bins の説明を追加しました。各ツール呼び出しにつき、標準エラー出力に構造化ログを1行出力するようになりました（ツール名、成否、処理時間（ms）、キーの接頭辞。引数は記録しません）。
• 0.2.0 — ホスト型 Streamable HTTP トランスポート、読み取り専用アノテーションを追加しました。レジストリゲートウェイ向けに、ヘッダー、パス、クエリからAPIキーを受け付けるようになりました。

質問例

• 「今週末を終えて、アルスヴェンスカンの優勝争いはどのような状況ですか？」
• 「フラメンゴは通常、試合の早い時間帯と遅い時間帯のどちらに得点しますか？」
• 「Kリーグの順位表を表示し、市場予想を上回っているチームを教えてください。」
• 「セリエBで、試合開始から15分間に失点していないチームはどこですか？」
• 「今シーズンのFootball Chartsの実際の予測成績はどうなっていますか？」

設定

環境変数	デフォルト	用途
FC_API_KEY	—（必須）	APIキー
FC_API_BASE	FC production API	セルフホスト／テスト用の上書き

プライバシーポリシー

この拡張機能は、会話の内容を除くツールリクエスト（リーグキー、チーム名、シーズン）をHTTPS経由でfootball-charts.comのAPIに送信します。リクエストはIPごとにレート制限されます。APIキーを設定した場合、そのキーでアカウントが識別され、使用量はキーごとにカウントされます。会話の内容は保存されません。Football Chartsのプライバシーポリシー： https://www.football-charts.com/privacy。お問い合わせ：[email protected]。

利用規約

個人利用および研究利用は、クレジット表記（「Data by football-charts.com」）を条件に無料です。データの再販売は禁止されています。有料プランの商用利用については、[email protected]までお問い合わせください。

ライセンス

MIT（サーバーコードのみ）。football-charts.com APIが提供するデータの著作権は© football-charts.comに帰属し、利用条件はhttps://www.football-charts.com/developersに記載されています。

Claude Codeプラグイン

このリポジトリはClaude Codeプラグイン（plugins/football-charts/）でもあります。上記のホスト型MCPサーバー（キー不要）とfootball-dataスキルを追加します：

/plugin install football-charts --marketplace ddevetak/footballcharts-mcp

Cursorプラグイン

このリポジトリはCursorプラグイン（.cursor-plugin/plugin.json）でもあります。上記のホスト型MCPサーバー（キー不要）と、ツールおよびREST APIについて説明するfootball-dataスキルを追加します。ローカルで試すには、リポジトリを~/.cursor/plugins/local/football-chartsにコピーし、Cursorを再読み込みして、CustomizeでFootball Charts MCPサーバーとスキルを確認してください。