FPL Intelligence 是一个 MCP（Model Context Protocol）服务器，目标是让 Claude 成为用户的梦幻英超（FPL）分析师。它连接官方 FPL API 获取实时数据，并提供 11 个分析工具。
用途：面向梦幻英超玩家，帮助完成队长选择、转会决策、对手阵容侦察、筹码使用时机和联赛预测等分析任务。
主要能力（11 个工具）：队长选择（captain picks）、转会建议（transfer suggestions）、球员对比（player comparison）、扣分计算（hit calculator）、筹码策略（chip strategy）、差异球员（differentials）、赛程展望（fixtures）、价格预测（price predictions）、实时积分（live points）、阵容侦察（squad scout），以及对手/联赛相关分析。
使用方式：
- 安装：需要 Python 3.12+。可通过 pip install fpl-intelligence 安装，或从源码安装。
- 连接到 Claude Desktop：在 Claude Desktop 配置中配置该 MCP 服务器（源码安装时需使用 uv 的完整绝对路径与仓库路径，可用 which uv 查找路径）。
- 重启 Claude Desktop：在 macOS 上使用 Cmd+Q 完全退出后重新打开，在 MCP 服务器图标（锤子图标）中查找 fpl。
- 向 Claude 提问：例如 "Analyze my FPL team 5456980 — who should I captain, who should I transfer in, and when should I use my chips?"。银行余额、免费转会和筹码会根据队伍 ID 自动检测。
队伍 ID 查找：访问 fantasy.premierleague.com → 点击 Points → 从 URL 中获取数字；联赛 ID 在小联赛（mini-league）URL 中。需使用 FPL 队伍 ID（如 5456980 的数字），而非用户名。
数据与隐私：连接官方 FPL API，使用与 FPL 网站相同的免费公开数据，所有数据实时。服务器在本地机器运行，通过 MCP 与 Claude Desktop 通信。无需 API 密钥、无需账号，除 FPL API 调用外数据不离开本机。
限制与注意事项：
- 环境要求 Python 3.12+，可用 python3 --version 检查。
- FPL API 会阻止不像来自浏览器的请求。可用 curl 测试可达性：返回 200 表示 API 正常，问题可能出在 Claude Desktop 沙盒；返回 403 表示网络阻断。
- Claude Desktop 沙盒可能提示批准对 fantasy.premierleague.com 的网络访问，若忽略需重启 Claude Desktop 并留意提示；日志位置：macOS 为 ~/Library/Logs/Claude/，Windows 为 %APPDATA%\Claude\logs\。
- VPN 或企业网络可能屏蔽 *.premierleague.com，可尝试断开 VPN 或切换个人网络。
- FPL API 在截止时间前后以及赛季之间（6-7月）会宕机，可在浏览器测试 fantasy.premierleague.com/api/bootstrap-static/。
- 源码安装需在 Claude Desktop 配置中使用 uv 完整绝对路径和仓库路径，并确保编辑正确的配置文件，然后完全退出并重开 Claude Desktop（macOS 用 Cmd+Q，而非仅关闭窗口）。
- 若仍不工作，可查看 Claude Desktop 日志中的错误，或在 issue 中提供操作系统、Python 版本、错误信息和上述 curl 测试输出。
- 支持渠道：参见 CONTRIBUTING.md 了解开发环境搭建与指南；另有安全策略（Security policy）。
