FPL MCP

あなたのFantasy Premier LeagueチームをAIで管理します。

MCPサーバーは、ClaudeのようなLLMクライアントが、あなたのFPLチームの読み取り、プレイヤーと試合の分析、移籍の提案、ミニリーグのライバルの偵察、さらに実際の移籍の実行、キャプテンの設定、チップの行使までを、すべて平易なチャットだけで済まできるようにします。

⚠️ 非公式です。 Premier Leagueとは無関係であり、承認も支持も関連もありません。 公開されているFPL APIを使用しています。実行はあなた自身のマシン上で、セッショントークンが コンピュータの外に出ることは決してなく、このツールやモデルがパスワードを見ることもありません。

デモ

1つの文で複数の操作——移籍、キャプテン変更、先発メンバー入替えまで、実際のチームに対してすべて実行します：

「ジョアン・ペドロをレンタルで移籍させて、ハヴェルツ？を加入させ、ハーランドをキャプテーテンにし、ル・フェの代わりにイェーツを先発に入れて」

Related MCP server: FPL MCP Server

ほかとの違い

ほとんどのFPLツールはデータを読むだけであり、あなたが手で適用するだけのアドバイスしか提供しません。このツールは次の点が違います：

• 実際にチームを管理 — 移籍、キャプテン、先発、チップを、本物として実行します。

• パスワードを一切扱わずにサインイン — 実際のブラウザが開き、公式のFPLページへあなた自身がログインし、セッショントークンだけが取得されます。

• ミニリーグを偵察 — ライバルのスカッドは公開されているため、あなたのリーグ内での所有率を計算し、あなたの優位点と脅威を報告します。

• ポジション対応のモデルで移籍を提案 — 最高ポイント、定番の安全な選択肢、順位を上げるための差別化選手、という3つの戦略があります。

ツール

サインインの仕組み（そしてどうして安全か）

FPLはトークンベースのログイン（PingOne OIDC）に移行しました。パスワードを聞き出す代わりに、login_to_fplは：

1. 公式FPLサイトで、実際のブラウザウィンドウを開きます。

2. あなたがそこで自分でサインインします。

3. セッショントークンがネットワークトラフィックから読み取られ、ローカルのtoken.txtに保存されます。

あなたのパスワードはFPL自身のページに入力されるだけであり、このコードにもモデルにも到達しません。ボット検知を回避することもなく、ログインを行うのは人間です。技術的な詳細は docs/FINDINGS.md を参照してください。

必要条件

• Python 3.12+

• uv

• Node.js（MCP Inspectorを開発で使用する場合のみ）

セットアップ

git clone https://github.com/MoayadAbbara/FPL-MCP.git
cd FPL-MCP
uv sync --extra browser      # includes Playwright for browser login
uv run playwright install chromium

Claudeに接続する

サーバーをMCPクライアントに登録します。Claude Codeの場合：

claude mcp add fpl -- uv run --directory /path/to/FPL-MCP python src/server.py

または、クライアントのMCP設定に追加します（.mcp.json / claude_desktop_config.json）：

{
  "mcpServers": {
    "fpl": {
      "command": "uv",
      "args": ["run", "python", "src/server.py"],
      "cwd": "/path/to/FPL-MCP"
    }
  }
}

クライアントを再起動すれば、あとは話しかけるだけです。

使い方

接続したら、自然言語で指示してください：

"Sign in to FPL"
"Show my team"
"Any injury news on Arsenal players?"
"Compare Haaland and Gyökeres"
"Suggest transfers — differential mode"
"Analyse my mini-league 123456"
"Transfer out Haaland, bring in João Pedro, and make Watkins captain"

モデルが適切なツールを呼び出し、チームに変更を加える操作については、何を行ったかを教えてくれます。

アーキテクチャ

階層構造になっており、各層はただその下の層だけを知っています：

src/
  tools/    MCP tool surface (thin glue: fetch -> domain -> format -> text)
  format/   raw data -> compact, model-friendly text
  domain/   pure FPL logic (scoring, suggestions, roster maths) — no HTTP, no MCP
  api/      FPL HTTP client
  auth/     token capture (browser) and storage
  server.py entry point

生のFPL JSONがモデルに届くことはありません。domain/、次にformat/を経由して、判断に関わるフィールドだけが残ります。

開発

uv run ruff format . && uv run ruff check --fix .   # format + lint
uv run python src/server.py                          # run the server (stdio)

注意事項

• シーズンに依存するツール（suggest_transfer、analyze_mini_league）は、シーズンが始まってから最適に動作します。最初の締め切りの前には、明確な「まだ」というメッセージが返ります。

• チーム管理の自動化は、FPLの利用規約に抵触する可能性があります。自分のチームのみに使い、個人利用に留め、求められたなら停止してください。

ライセンス

MIT