Fantasy Football Manager MCP

技能简介

Fantasy Football Manager 是一款基于 Model Context Protocol（MCP）的 ESPN 梦幻足球管理 MCP 服务器，专为 Claude Code 等 AI 编程助手设计。它通过 17 个分析工具和 16 个 ESPN 实时观察工具，让 AI 直接代管梦幻足球队伍——包括每周阵容推荐、自由球员认领、伤病名单移动等赛季操作，全程通过 HTTP 协议完成，无需启动浏览器或 Playwright。

该技能包还包含一份选秀助手，持续运行蒙特卡洛模拟，以及一个多队协调服务器，支持同时管理多支球队。目前支持美式足球，未来可扩展其他运动项目。

核心能力

• 全自动阵容推荐：基于当前赔率和球员锁定期望，计算出合法且最优的每周阵容配置
• HTTP 赛季操作：无需 Chrome 或 Playwright，直接通过认证 HTTP 请求完成自由球员认领、球员下放、伤病名单移动等操作
• 多队协调管理：一个 Portfolio MCP 支持同时管理多支球队，每队独立 SQLite 状态库、独立策略和独立待处理声明
• 选秀模拟引擎：蒙特卡洛持续模拟，支持蛇形选秀顺序、名单上限、起始位完成和五种策略偏好
• 服务器协调模式：可在无头 Linux 服务器上部署，支持 PostgreSQL 归档导出和私有备份
• Fieldroom 本地仪表板：多队管理仪表板，可视化查看名单、健康度、赔率、操作限制和提案变更
• 三重操作模式：Advisory（仅推荐）、Review（确认后提交）、Automatic（按策略自动执行）

安装配置

前提条件

• Python 3.11 或更高版本
• uv 包管理器
• ESPN 账号（用于 HTTP 认证）

安装步骤

# 方式一：直接运行演示（无需 ESPN 账号）
uvx --from fantasy-football-manager==0.4.0 fantasy-football-manager --demo

# 方式二：完整安装
uv sync --locked

v0.4.0 预览版安装（需 ESPN 认证）

uv sync --no-dev --extra session-import

1. 配置受保护的会话文件，设置 FFM_ESPN_CREDENTIAL_FILE 环境变量
2. 将两个 MCP 服务器连接到同一个每队状态目录
3. 使用 get_manager_config 读取保存的操作模式
4. 调用 espn_connect，传入 league、team、season、phase="season"、transport="http"
5. 调用 espn_sync 读取当前名单、赔率、锁定期望和待处理交易
6. 调用 recommend_lineup 计算合法阵容
7. 确认操作模式后再执行操作

使用步骤

1. 连接 ESPN：调用 espn_connect 连接到指定的 ESPN 联赛和球队
2. 同步数据：调用 espn_sync 获取当前名单、健康度、赔率和待处理交易
3. 获取推荐：调用 recommend_lineup，系统根据当前赔率和锁定期望计算最优阵容
4. 选择操作模式：Advisory（仅看推荐不执行）、Review（确认后执行）、Automatic（按策略自动执行）
5. 执行交易：在 Review 或 Automatic 模式下，提交自由球员认领/下放/阵容交换请求
6. 启动自动化：调用 espn_start_automation 开启赛季自动化，每周自动检查并执行阵容调整

适用场景

• 日常赛季管理：无需手动登录 ESPN 网站，AI 自动完成每周阵容调整
• 自由球员市场分析：系统自动追踪可认领球员并给出推荐操作
• 选秀辅助：选秀夜持续模拟，AI 代替人工追踪选秀进度并给出实时建议
• 多队管理：同时管理多支梦幻足球队伍，统一监控和操作
• 服务器自动化：在云端 Linux 服务器部署，完全无人值守运行
• 草根联盟管理：联盟成员不足时，AI 可作为虚拟经理参与管理

适用人群

• 梦幻足球玩家：管理多支球队或参与多个联赛的玩家
• 数据驱动玩家：希望通过算法和赔率数据优化阵容决策的玩家
• AI 工具爱好者：喜欢用 AI 自动化日常事务的技术型用户
• 联盟组织者：管理多个联赛、需要在选秀夜提供实时辅助的工具

工作原理

Fantasy Football Manager MCP 由三个 MCP 服务器组成：

• Manager MCP 服务器：提供 17 个分析工具，覆盖阵容政策计算、健康检查和行动限制
• ESPN MCP Companion：提供 16 个实时观察工具，支持受控交易操作和持续运行
• Portfolio MCP：为所有已配置球队、球员、保存的提案和阵容分析提供统一管理接口

HTTP 赛季适配器负责与 ESPN 服务器通信，所有操作均通过 ESPN 认证 HTTP 会话完成。系统使用 SQLite 数据库存储每队状态，PostgreSQL 为可选归档后端，支持定期批量导出和检查点提交。

官方链接

• GitHub 仓库：https://github.com/krmisystems/fantasy-football-manager
• HTTP 赛季验收文档：https://github.com/krmisystems/fantasy-football-manager/blob/main/docs/HTTP_SEASON_ACCEPTANCE.md
• ESPN 工作流与工具参考：https://github.com/krmisystems/fantasy-football-manager/blob/main/docs/ESPN_AUTOMATION.md
• 服务器部署指南：https://github.com/krmisystems/fantasy-football-manager/blob/main/docs/SERVER.md