Fpl Intelligence について
Fpl Intelligence は FPL マネージャー向けの MCP サーバーで、公式 FPL API のリアルタイムデータを使い、Claude にチーム、選手、日程、リーグの分析ツールを提供します。
主な機能
- 01チームの個別分析
- 02主将と移籍の提案
- 03選手比較とヒット計算
- 04チップ使用時期と穴場選手の探索
- 05ライブポイントと価格予測
- 06ライバルとリーグの分析
活用シーン
- 01次節の主将を選ぶ
- 02予算と無料移籍数を踏まえて補強を検討する
- 03今後の節に向けて選手を比較する
- 04ライバルを追跡しリーグ優勝確率を見積もる
MCP 対応
ローカルの MCP サーバーが Claude Desktop に接続し、FPL 分析ツールを提供します。公式 FPL API を呼び出し、README によると、その API 通信以外でデータがマシン外に送られることはありません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
FPL Intelligence — MCP サーバー
ClaudeをFPLアナリストに変えましょう。キャプテンの選定、移籍のアドバイス、ライバルの調査、チップを使うタイミング、リーグの予測を、リアルタイムのFPLデータに基づいて提供します。
クイックスタート
ステップ 1 — インストール
Python 3.12+が必要です。
pip install fpl-intelligence
ステップ 2 — Claude Desktopに接続
fpl-intelligence --setup
ステップ 3 — Claude Desktopを再起動
終了し(macOSでは Cmd+Q)、再度開きます。MCP サーバーのアイコン(ハンマーのアイコン)の下にある fpl を探してください。
ステップ 4 — FPLについてClaudeに何でも質問
「FPLチーム 5456980 を分析して。キャプテンにすべき選手、獲得すべき選手、チップを使うタイミングを教えて。」
これだけです。チームIDから、銀行残高、フリー移籍数、チップがすべて自動検出されます。
チームIDはどこにありますか?
fantasy.premierleague.comにアクセスし、Pointsをクリックして、URLから数字を確認してください。
https://fantasy.premierleague.com/entry/YOUR_TEAM_ID/event/30
リーグIDはミニリーグのURLにあります。
https://fantasy.premierleague.com/leagues/YOUR_LEAGUE_ID/standings/c
12 個のツール
| ツール | 内容 |
|---|---|
fpl_manager_hub | キャプテン、移籍、差別化候補、対戦カード、価格変動リスクを含む、パーソナライズされた総合分析 |
captain_pick | 調子、xG、対戦カード、ICTインデックスに基づいて評価したキャプテン候補トップ5 |
transfer_suggestions | チームと予算に基づく、獲得・放出候補の提案 |
player_comparison | あらゆる指標で選手2~4人を直接比較 |
is_hit_worth_it | -4を受け入れるべきか?N節にわたる純ポイントを予測 |
chip_strategy | DGW予測を考慮した、各チップを使う最適なゲームウィーク |
differential_finder | 保有率以上の活躍をしている隠れた逸材 |
fixture_outlook | 今後の対戦難易度に基づくチームランキング |
price_predictions | 今夜、価格が上昇・下落する選手 |
live_points | ライブスコア、予想ボーナス、自動交代のシナリオ |
rival_tracker | ミニリーグのライバルを調査 — 差別化候補、弱点、予想される動き |
league_analyzer | リーグの優勝確率 — 優勝候補とその理由 |
squad_scout | FPLの非公開データを使った詳細な調査 — ep_next、セットプレー、出場停止リスク |
プロンプトの例
"Give me the full breakdown on team 5456980 — captain, transfers, everything"
"I have 2 free transfers and 1.5m in the bank. Who should I bring in?"
"Salah vs Palmer vs Saka — who's the best pick for the next 5 gameweeks?"
"I want to bring in Haaland for a -4. Is it worth the hit?"
"I still have my bench boost and triple captain. When should I use them?"
"Find me some differentials under 3% ownership that are actually returning points"
"It's 60 minutes into the games — how's my team doing? Any auto-subs?"
"Show me everything about mini-league 1189955 — who's going to win?"
"How do I beat my rivals in league 1189955? I'm team 5456980"
"Which players are about to drop in price tonight? I need to sell before the deadline"
"Scout my squad — who's nailed, who's at risk of rotation, any suspension danger?"
仕組み
FPL Intelligenceは公式のFPL APIに接続します。これはFPLのウェブサイトを支えるものと同じ、無料の公開データです。すべてのデータはリアルタイムです。エンドポイントのドキュメントについては、PostmanのFPL APIリファレンスをご覧ください。
サーバーはお使いのマシン上でローカルに動作し、MCP経由でClaude Desktopと通信します。APIキーもアカウントも不要です。FPL APIへの呼び出しを除き、データがお使いのマシンから外部に送信されることはありません。
ソースからインストール
git clone https://github.com/dohyung1/x402-fpl-api.git
cd x402-fpl-api
uv sync
次に、Claude Desktopの設定で、uvとリポジトリのフル絶対パスを指定します。
{
"mcpServers": {
"fpl": {
"command": "/full/path/to/uv",
"args": ["run", "--directory", "/full/path/to/x402-fpl-api", "mcp_server.py"]
}
}
}
which uvを実行するとuvのパスを確認できます(例:/Users/you/.cargo/bin/uv)。
トラブルシューティング
FPL API の呼び出しがブロックされる/403 エラーが発生する
FPL API は、ブラウザーからのリクエストに見えないリクエストをブロックします。
API に接続できるかテストする:
curl -s -o /dev/null -w "%{http_code}" \
-H "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)" \
https://fantasy.premierleague.com/api/bootstrap-static/
200 が返されますか?API は動作しています。問題は Claude Desktop のサンドボックスにある可能性があります(下記を参照)。403 が返されますか?ネットワークによってブロックされています。
Claude Desktop のサンドボックス: Claude Desktop で、fantasy.premierleague.com へのネットワークアクセスを許可するよう求められることがあります。この確認を閉じてしまった場合は、Claude Desktop を再起動し、確認メッセージが表示されるかどうかを確認してください。ログは ~/Library/Logs/Claude/(macOS)で確認できます。
VPN/企業ネットワーク: 一部のネットワークでは *.premierleague.com がブロックされます。VPN を切断するか、個人用ネットワークに切り替えてみてください。
FPL API の停止: API は締め切り時刻前後やシーズン間(6~7 月)に停止することがあります。ブラウザーでテストしてください:fantasy.premierleague.com/api/bootstrap-static/
サーバーが起動しない/「Failed to spawn process」/コマンドが見つからない
まず、自動セットアップを再実行してください。
fpl-intelligence --setup
それでも解決しない場合は、手動でセットアップしてください。
ステップ 1 — 実行ファイルを探す:
find ~ -name "fpl-intelligence" -type f 2>/dev/null
ステップ 2 — 設定でフルパスを使用する:
{
"mcpServers": {
"fpl": {
"command": "/full/path/to/fpl-intelligence"
}
}
}
ステップ 3 — 正しい設定ファイルを編集していることを確認する:
# macOS — open the file directly
open ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json
ステップ 4 — Claude Desktop を完全に終了してから、再度開きます(macOS では Cmd+Q を押します。ウィンドウを閉じるだけではありません)。
それでも動作しませんか? Claude Desktop のログでエラーを確認してください。
- macOS:
~/Library/Logs/Claude/ - Windows:
%APPDATA%\Claude\logs\
Python バージョンエラー: Python 3.12 以降が必要です。python3 --version で確認してください。
Invalid team_id エラーが発生する
ユーザー名ではなく、FPL チーム ID(5456980 のような数字)を使用してください。fantasy.premierleague.com → Points に移動し、URL を確認すると ID が見つかります。
それでも解決しませんか?
お使いの OS、Python のバージョン、エラーメッセージ、および上記の curl テストの出力を添えて、issue を作成してください。
コントリビューション
開発環境のセットアップとガイドラインについては、CONTRIBUTING.md を参照してください。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。