Commish AI

ESPN梦幻足球MCP集成

一个全面的MCP（模型上下文协议）服务器，用于将ESPN梦幻足球与Cursor AI集成，专为高级阵容优化和数据驱动决策而设计。

快速开始

1.安装依赖项

cd fantasy_football_server
pip install -r requirements.txt

2.配置你的联赛

创建一个 .env 文件在 fantasy_football_server 包含您的联盟配置的目录：

# Required: Your ESPN Fantasy League Configuration
LEAGUE_ID=your_league_id_here
TEAM_ID=your_team_id_here
YEAR=2025

# Required: Tavily Search API (for advanced research)
TAVILY_API_KEY=your_tavily_api_key

# Optional: ESPN Authentication (only for private leagues)
ESPN_S2=your_espn_s2_cookie
ESPN_SWID=your_espn_swid_cookie

获取您的联盟信息：

1. 前往您的ESPN梦幻足球联赛页面
2. 联盟ID位于URL中： https://fantasy.espn.com/football/league?leagueId=XXXXXX
3. 球队ID通常为1-12（或联盟中有多少支球队）

获取您的ESPN Cookie（仅限私人联赛）：

1. 在浏览器中登录ESPN梦幻足球
2. 打开开发人员工具（F12或右键单击→ 检查）
3. 转到 应用 选项卡（Chrome）或 存储 选项卡（Firefox）
4. 在左侧边栏中，展开 Cookie
5. 点击 https://fantasy.espn.com
6. 查找并复制这两个cookie值：

- espn_s2 -复制整个值（它是一个长字符串） - SWID -复制整个值（它是GUID格式）

1. 将这些值粘贴到您的 .env 文件

获取Tavilly API密钥：

1. 注册地址： https://tavily.com/
2. 从仪表板复制API密钥
3. 免费套餐包括每月1000次搜索

3.重新启动游标

设置凭据后，重新启动Cursor以加载MCP服务器。该服务器将在您的MCP工具中作为“espn梦幻足球”提供。

可用工具

ESPN幻想（当前联赛数据）

• get_roster -获取完整的球队名单，包括统计数据和伤病信息
• is_available -检查玩家是否处于豁免状态
• get_top_available -按位置获取前N名可用球员

高级研究与分析

• summarize_players -多个玩家的快速匹配摘要
• injury_report -详细的伤病报告和幻想影响
• analyze_player -全面的玩家分析和专家排名
• find_best_adds -专家豁免电报建议
• search_player_usage_trends -玩家使用趋势和快照共享数据
• search_vegas_odds -拉斯维加斯比赛赔率和投注线
• fantasy_football_search -自定义梦幻足球搜索

游标用法示例

MCP服务器运行后，您可以在Cursor中使用它进行高级梦幻足球分析：

基本排班管理

"Get my current roster"
"Is CeeDee Lamb available in my league?"
"Show me the top 5 available running backs"

高级玩家分析

"Analyze Saquon Barkley for Week 9 in PPR scoring"
"Get injury report for Justin Jefferson Week 9"
"Search usage trends for DeAndre Hopkins Week 9"
"Find Vegas odds for the Cowboys vs Eagles Week 9"

排班优化工作流程

"Find the best waiver wire pickups for Week 9"
"Compare my WR2 options: Amari Cooper vs Mike Evans"
"Analyze my RB depth and suggest streaming options"
"Check snap share trends for my flex players"

每周分析工作流

完成每周准备

1. "Get my current roster" - Review team status
2. "Find best waiver wire pickups for Week 9" - Identify targets
3. "Analyze [Player Name] Week 9" - Deep dive on key players
4. "Search Vegas odds for [Team] Week 9" - Check game environment
5. "Get injury report for [Player Name] Week 9" - Monitor health status

开始/坐下决策过程

1. "Summarize players: [Player A, Player B] Week 9 PPR" - Quick comparison
2. "Search usage trends for [Player Name] Week 9" - Volume analysis
3. "Search Vegas odds for [Player Team] Week 9" - Game script analysis
4. "Analyze [Player Name] Week 9 PPR" - Comprehensive evaluation

流媒体策略（D/ST、K、TE）

1. "Get top available DEF Week 9" - Find streaming options
2. "Search Vegas odds for [Opponent Team] Week 9" - Check turnover potential
3. "Fantasy football search: Week 9 D/ST streaming recommendations" - Expert advice
4. "Analyze [Streaming Option] Week 9" - Final evaluation

贸易分析

1. "Analyze [Trade Target] Week 9 PPR" - Evaluate acquisition
2. "Search usage trends for [Your Player] Week 9" - Assess what you're giving up
3. "Find best adds Week 9 RB" - Check waiver alternatives
4. "Search Vegas odds for [Both Teams] Week 9" - Compare situations

项目结构

FantasyFootball/
├── casefiles/               # Decision case files (auto-generated)
├── fantasy_football_server/
│   ├── server.py            # Main MCP server
│   ├── espn_client.py       # ESPN API wrapper
│   ├── tavily_client.py     # Tavily search client
│   ├── requirements.txt     # Python dependencies
│   └── env_template.txt     # Environment configuration template
└── README.md               # This file

特性

• ✅ ESPN梦幻足球整合（公共和私人联赛）
• ✅ 使用Tavily API进行实时网络搜索以进行专家分析
• ✅ 全面的玩家分析，包括使用趋势和快照共享数据
• ✅ 拉斯维加斯赔率整合用于游戏脚本分析
• ✅ 带有幻想影响评估的伤害报告
• ✅ 放弃专家建议
• ✅ 自定义梦幻足球搜索功能
• ✅ 所有响应的标准化JSON格式
• ✅ 安全环境变量配置
• ✅ 完整的错误处理和验证
• ✅ 高级排班优化工作流程
• ✅ 数据驱动的决策工具

需求

• Python 3.8+
• ESPN梦幻足球账户（可选，适用于私人联赛）
• Tavilly API密钥（高级研究功能所需-提供免费层）
• 支持MCP的游标IDE

故障排除

服务器未启动

• 验证是否安装了所有依赖项： pip install -r fantasy_football_server/requirements.txt
• 检查Python是否在您的PATH中
• 查看Cursor的MCP日志以了解错误消息

配置问题

• 确保 .env 文件在 fantasy_football_server 目录
• 验证 LEAGUE_ID, TEAM_ID，以及 YEAR 设置正确
• 检查一下 TAVILY_API_KEY 有效且未过期

ESPN联赛接入

• 对于公共联赛：无需身份验证，只需联赛/球队ID
• 对于私人联赛：如果ESPN Cookie已过期，请重新复制
• 仔细检查ESPN URL中的联赛ID
• 团队ID为1索引（第一团队=1，第二团队=2，以此类推）

Tavily搜索问题

• 验证您没有超过速率限制（免费层每月1000次搜索）
• 确保互联网连接正常
• 检查搜索查询是否具体且格式正确

许可证

该项目按原样提供，供幻想足球联赛个人使用。