AI导哈

梦幻足球AI管理助手

一个结合GitHub Actions自动化工作流和Claude Desktop集成的智能ESPN梦幻足球管理系统，提供阵容优化、目标球员推荐和交易分析的AI驱动建议。

  • by JayMishra-source
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 JayMishra-source/Fantasy-Football-AI-CoManager

使用说明

梦幻足球AI CoManager🏈🤖

一个智能的ESPN梦幻足球管理系统，通过MCP（模型上下文协议）将自动化的GitHub Actions工作流与Claude Desktop集成相结合。该系统分析您的ESPN联赛，并为阵容优化、豁免线目标和交易分析提供人工智能驱动的建议。

🎯 这有什么作用

用AI改变你的梦幻足球管理：

  • 分析您的ESPN联赛 -从ESPN Fantasy API获取实时数据
  • 优化阵容 -根据投影和匹配设置最佳阵容
  • 确定豁免目标 -在比赛前找到突破性球员
  • 评估交易 -提供具有预期影响的公平贸易分析
  • 自动运行 -GitHub操作或通过Claude Desktop按需

🚀 快速开始

选择你的道路

路径1:GitHub操作自动化（设置它并忘记它）

最适合：希望将自动化的每日/每周分析发送到Discord的用户

路径2：克劳德桌面+MCP（交互式人工智能助理）

最适合：希望对话式人工智能帮助做出幻想决策的用户

路径3：本地POC（开发和测试）

最适合：希望测试ESPN API集成的开发人员

📚 文档

核心文件

对于开发者

🛠️ 安装

先决条件

  • Node.js 16+和npm
  • ESPN梦幻足球账号
  • GitHub帐户（用于操作）或Claude Desktop（用于MCP）

选项1:GitHub操作设置

  1. 分叉此存储库
  2. 获取ESPN Cookie （请参阅身份验证部分）
  3. 添加GitHub机密:
    ESPN_S2          # Your espn_s2 cookie
ESPN_SWID        # Your SWID cookie  
LEAGUE_1_ID      # Your league ID
LEAGUE_1_TEAM_ID # Your team ID
GEMINI_API_KEY   # Google Gemini API key (free tier)
DISCORD_WEBHOOK_URL # Discord channel webhook
  4. 启用GitHub操作 在你的叉子里
  5. 自动运行:
    • 每天美国东部时间上午8点
    • 比赛期间每小时（周日/周一/周四）
    • 随时手动触发

选项2:Claude桌面+MCP设置

  1. 克隆存储库:

    git clone https://github.com/yourusername/FantasyCoManager.git
cd FantasyCoManager/fantasy-engine/mcp-server

  2. 构建MCP服务器:

    npm install
npm run build

  3. 配置Claude桌面 (~/.config/Claude/claude_desktop_config.json):

    {
  "mcpServers": {
    "fantasy-football": {
      "command": "node",
      "args": ["/path/to/fantasy-engine/mcp-server/dist/index.js"],
      "cwd": "/path/to/fantasy-engine/mcp-server"
    }
  }
}

  4. 重新启动克劳德桌面 并询问：

    • “帮我组建我的幻想团队”
    • “这周我该从谁开始？”
    • “查找豁免线目标”

方案3：地方发展POC

# Clone and navigate
git clone https://github.com/yourusername/FantasyCoManager.git
cd FantasyCoManager/fantasy-engine

# Quick start (both frontend and backend)
./start-poc.sh

# Or manually:
cd server && npm install && npm run dev  # Backend on :3003
cd client && npm install && npm run dev  # Frontend on :5173

🔐 ESPN身份验证

获取您的ESPN Cookie

  1. 登录ESPN幻想频道 在Chrome/Firefox中
  2. 打开DevTools （F12）→ 应用→ Cookie
  3. 在fantasy.espn.com上查找:
    • espn_s2 -长身份验证令牌
    • SWID -大括号中的UUID，如 {123-456-789}
  4. 复制这些值 用于配置

查找您的联赛信息

从您的ESPN梦幻联赛网址：

https://fantasy.espn.com/football/league?leagueId=123456
                                              ^^^^^^ Your League ID

https://fantasy.espn.com/football/team?leagueId=123456&teamId=3
                                                         ^^^^^^ Your Team ID

💡 使用示例

使用GitHub操作

配置后，系统会自动：

  • 星期四下午6点：赛前优化
  • 周日上午11点：最终阵容检查
  • 周一上午8点：豁免线分析
  • 星期二上午10点：贸易建议

结果已发送到您的Discord频道。

使用克劳德桌面

自然地问克劳德：

  • “显示我当前的名册”
  • “我应该从谁开始：球员A还是球员B？”
  • “本周最好的豁免是什么？”
  • “这是公平的贸易吗：我的RB1换他们的WR1？”

使用本地POC

访问http://localhost:5173致：

  • 使用ESPN实时数据查看您的名单
  • 测试ESPN API端点
  • 查看玩家预测和统计数据

🏗️ 建筑

系统组件

┌─────────────────────────────────────────────────┐
│                   User Interfaces                │
├──────────┬────────────┬────────────┬────────────┤
│  GitHub  │   Claude   │    Web     │    CLI     │
│  Actions │  Desktop   │    POC     │   Tools    │
└──────────┴────────────┴────────────┴────────────┘
                           │
┌─────────────────────────────────────────────────┐
│              Core Services Layer                 │
├──────────────────────────────────────────────────┤
│  • ESPN API Integration (Authentication, Data)   │
│  • FantasyPros Rankings Integration              │
│  • AI Orchestration (Gemini, Claude, GPT)        │
│  • Data Processing & Slot Categorization         │
└─────────────────────────────────────────────────┘
                           │
┌─────────────────────────────────────────────────┐
│                 Data Sources                     │
├──────────────────────────────────────────────────┤
│  • ESPN Fantasy API (Rosters, Matchups, Stats)   │
│  • FantasyPros (Expert Rankings, Projections)    │
│  • Weather API (Game Conditions)                 │
│  • News Feeds (Injury Reports, Breaking News)    │
└─────────────────────────────────────────────────┘

按组件列出的主要功能

GitHub操作自动化 (fantasy-engine/automation/)

  • 第四阶段高级情报系统
  • 计划和手动工作流
  • Discord 网钩通知
  • 多联盟支持

MCP服务器 (fantasy-engine/mcp-server/)

  • 10+用于ESPN数据访问的MCP工具
  • 排队优化算法
  • 贸易和豁免分析
  • 直接集成Claude桌面

网络POC (fantasy-engine/client/ + fantasy-engine/server/)

  • React 19+TypeScript前端
  • Express+Puppeter后端
  • ESPN身份验证处理
  • API测试接口

共享库 (fantasy-engine/shared/)

  • ESPN API客户提供2025赛季支持
  • 名册位置分类（26种职位类型）
  • 投影归一化（每周与季节）
  • AI工作流编排

🔧 最近的改进

ESPN数据收集修复（已完成）

✅ 固定每周与季节预测逻辑
✅ 通过位置验证增强FantasyPro玩家匹配
✅ 标准化ESPN API使用2025赛季
✅ 改进了所有名册职位的职位分类
✅ 添加了用于调试的全面日志记录

存储库清理（已完成）

✅ 删除了重复的MCP服务器（节省了40%的存储库大小）
✅ 清理了18个过时的文档文件
✅ 精简为最新的基本文档

🐛 故障排除

常见问题

“ESPN身份验证失败”

  • Cookie在约30天后过期
  • 从ESPN网站获取新鲜饼干
  • 用新值更新secrets/config

“没有可用的名册数据”

  • 验证联赛ID和球队ID是否正确
  • 检查联盟是否为私有（需要身份验证）
  • 确保Cookie来自正确的ESPN帐户

“端口已在使用中”（本地POC）

  • 另一个实例正在运行
  • 终止现有进程或使用其他端口

GitHub操作未运行

  • 检查fork中是否启用了Actions
  • 验证所有机密设置是否正确
  • 检查工作流日志中的特定错误

调试命令

# Test ESPN authentication
curl -H "Cookie: espn_s2=YOUR_COOKIE; SWID=YOUR_SWID" \
  "https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2025/segments/0/leagues/YOUR_LEAGUE_ID"

# Check MCP server
node fantasy-engine/mcp-server/dist/index.js

# View GitHub Actions logs
# Go to Actions tab → Select workflow → View logs

📊 演出

  • ESPN API响应：平均<500ms
  • 阵容优化：<2秒
  • 全面分析：<5秒
  • MCP工具执行：每个<1秒
  • GitHub操作运行时：总共约2-3分钟

🔒 安全与隐私

  • ESPN Cookie存储为机密（GitHub）或本地（MCP/POC）
  • 未向第三方发送凭据
  • 人工智能提供商只接收匿名的幻想数据
  • 所有数据处理都在您的环境中进行

🤝 贡献

欢迎投稿！需要改进的地方：

  • Claude的其他MCP工具
  • 增强的交易算法
  • 更多LLM提供商支持
  • 王朝联赛特征
  • Keeper联赛优化

📝 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🙏 致谢

  • ESPN幻想API（非官方）
  • FantasyPro专家排名
  • 克劳德和MCP的肖像
  • Google for Gemini API
  • 梦幻足球社区

内置于❤️ 适用于想要人工智能优势的梦幻足球经理

不隶属于ESPN或迪士尼。在ESPN的服务条款范围内负责任地使用。

相关 MCP