梦幻足球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集成的开发人员
📚 文档
核心文件
- 好友设置指南 -非开发人员的简易设置指南
- -自动化工作流程的可视化流程图
- MCP+Claude桌面流程 -与Claude Desktop集成
- 技术修复 -最近ESPN API数据收集改进
- 第四阶段情报 -高级AI系统文档
对于开发者
🛠️ 安装
先决条件
- Node.js 16+和npm
- ESPN梦幻足球账号
- GitHub帐户（用于操作）或Claude Desktop（用于MCP）
选项1:GitHub操作设置
- 分叉此存储库
- 获取ESPN Cookie （请参阅身份验证部分）
- 添加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- 启用GitHub操作 在你的叉子里
- 自动运行:
- 每天美国东部时间上午8点 - 比赛期间每小时（周日/周一/周四） - 随时手动触发
选项2:Claude桌面+MCP设置
- 克隆存储库:
git clone https://github.com/yourusername/FantasyCoManager.git
cd FantasyCoManager/fantasy-engine/mcp-server- 构建MCP服务器:
npm install
npm run build- 配置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"
}
}
}- 重新启动克劳德桌面 并询问：
- “帮我组建我的幻想团队” - “这周我该从谁开始？” - “查找豁免线目标”
方案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
- 登录ESPN幻想频道 在Chrome/Firefox中
- 打开DevTools （F12）→ 应用→ Cookie
- 在fantasy.espn.com上查找:
- espn_s2 -长身份验证令牌 - SWID -大括号中的UUID，如 {123-456-789}
- 复制这些值 用于配置
查找您的联赛信息
从您的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的服务条款范围内负责任地使用。*