Fantasy Football Manager 是一个面向 ESPN 梦幻橄榄球球队管理的开源工具,专为 Codex 和其他 Model Context Protocol(MCP)客户端设计。它允许用户连接自己的 ESPN 联盟,同步球队阵容,并根据当前预测计算合法的每周阵容。
主要能力方面,管理器 MCP 服务器提供 17 个工具,涵盖分析、策略和联盟状态管理;ESPN MCP 伴随服务器提供 16 个工具,用于实时观察、受控交易和持续运营;组合 MCP 额外提供 5 个工具,支持所有已配置的球队、球员、已保存提案和阵容分析。HTTP 赛季操作包括阵容调整、自由球员添加、豁免申请、裁员和伤病储备移动。选秀支持保留了现有的浏览器适配器,提供连续蒙特卡洛模拟的选秀助手,以及用于多团队的服务器协调器。
使用方式上,项目需要 Python 3.11 或更高版本以及 uv。用户需要自己的 ESPN 账户,并通过受保护的会话文件提供 HTTP 认证(配置 FFM_ESPN_CREDENTIAL_FILE)。可选地,Linux 导入功能可以从现有配置文件中仅读取两个 ESPN 会话 Cookie,而无需启动浏览器。两个 MCP 服务器需要连接到相同的每队状态目录。基本步骤包括:读取保存的操作模式(get_manager_config),调用 espn_connect 连接联盟(指定联赛、球队、赛季、phase="season"、transport="http" 和计分周),调用 espn_sync 读取当前阵容、预测、锁定和待处理交易,调用 recommend_lineup 计算合法阵容,并在启用所需操作模式前读取 espn_get_status。项目还提供本地仪表板 Fieldroom,可通过 http://127.0.0.1:8765/ 访问,用于检查阵容、来源健康、预测、操作限制和拟议变更。选秀操作需要安装浏览器扩展,并依赖 Google Chrome。基础 HTTP 安装不需要浏览器。
适用场景主要是 ESPN 梦幻橄榄球的球队管理和选秀辅助。用户可以在赛季中自动化阵容管理,设置操作模式和限制,并通过 espn_start_automation 启动自动化。选秀时,可以连接 phase="draft",同步并验证完整历史和当前选秀权,设置选秀策略、操作模式和限制,然后启动自动化。项目还支持在服务器上安装赛季协调器,无需客户端电脑、Chrome 进程或显示服务即可运行。
限制方面,该项目仅实现了橄榄球这一运动。需要用户自己的 ESPN 账户,且部分功能如实时豁免处理、IR 移动和计分周滚动仍标记为“未测试”。选秀模拟的可用性估计是条件性的,不保证球员能存活到下一个选秀权,更多试验也无法纠正过时输入或预测错误。模型不报告冠军概率。自动提交需要正确的球队在时钟上,并且 ESPN 自动选秀必须已验证禁用。每个实时提交在 HTTP 请求或选秀点击前会获得持久化声明,服务会验证最终的 ESPN 状态,不确定的结果会阻止另一次提交,直到协调完成。espn_stop_automation 可以暂停新操作,但不会撤销已提交的操作。浏览器模式接受可选的 cdp_url 用于显式回环浏览器调试端点。用户需保持配置文件、凭据、数据库、日志和真实联盟导出文件在 Git 之外。版本 0.4.0 为预览版,已通过五队 HTTP 观察扫描,并确认了自动自由球员添加/裁员及后续阵容交换两项 HTTP 操作,但五队赛季结果和不间断赛季运营仍未验证。