FPL MCP

使用 AI 管理你的梦幻英超球队。 一个 MCP 服务器，让 Claude 等 LLM 客户端能够读取你的 FPL 球队、分析球员和赛程、建议转会、侦察你迷你联赛中的对手，并实际执行转会、设置队长和使用筹码——全部通过自然语言对话完成。

⚠️ 非官方。 与英超联赛无关联、未经其认可，也与其无任何联系。使用公共 FPL API。完全在你自己的机器上运行——你的会话令牌永远不会离开你的电脑，你的密码也永远不会被此工具或模型看到。

演示

一句话，多个操作——一次转会、一次队长变更和一次阵容调整，全部在真实球队上执行：

"将 João Pedro 转出，引入 Havertz，让 Haaland 担任队长，并将 Yates 换入首发十一人替换 Le Fée"

Related MCP server: FPL MCP Server

与众不同之处

大多数 FPL 工具只能读取数据并提供建议，然后你需要手动操作。而这个工具：

• 真正管理你的球队——转会、队长、阵容和筹码，全部真实执行。

• 登录时从不接触你的密码——会打开一个真实浏览器，你在官方 FPL 页面上登录，仅捕获会话令牌。

• 侦察你的迷你联赛——对手的阵容是公开的，因此它会计算你所在联赛内的拥有率，并告诉你你的优势和威胁。

• 使用位置感知模型建议转会——三种策略：最佳得分、安全的模板选择，或用于提升排名的差异化选择。

工具

登录方式（以及为何安全）

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_transfers、analyze_mini_league）在赛季开始后效果最佳；在第一个截止日期之前，它们会返回一条明确的"尚未开始"消息。

• 自动化球队管理可能会触碰 FPL 服务条款。请仅用于你自己的球队，保持个人使用，如果被要求停止，请立即停止。

许可证

MIT