梦幻足球MCP服务器

一个用于Yahoo梦幻足球与Claude Desktop集成的模型上下文协议服务器,提供阵容优化、选秀辅助、联盟管理和增强的阵容管理功能。

  • by carterfawson
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 carterfawson/fantasy-football-mcp

使用说明

增强型梦幻足球MCP服务器

用于雅虎梦幻足球与克劳德桌面集成的模型上下文协议(MCP)服务器。具有先进的阵容优化、选秀协助、全面的联赛管理和增强的阵容管理能力。

🙏 归因

本项目基于 derekrbreese/梦幻足球mcp公众特别感谢Derek Breese最初的概念、架构和脚手架,使这个增强版本成为可能。

✨ 此分叉中的增强功能

  • 加强名册管理:通过智能位置变化检测修复了“位置已填充”错误
  • 工作豁免电汇交易:功能齐全的添加/删除播放器功能,具有适当的Yahoo API集成
  • 豁免状态跟踪:监测未决豁免索赔及其批准状态的新功能
  • 单人位置更改:更安全的阵容管理,一次更换一名球员
  • 改进了错误处理:全面的响应解析和详细的调试信息
  • 固定导入依赖关系:解决sleeper_api和其他模块导入问题
  • 雅虎API合规性:更新了XML格式,以符合雅虎的确切规格

特性

  • 多联盟支持:管理所有雅虎梦幻足球联赛
  • AI驱动的优化:具有多种策略的高级阵容建议
  • 起草助理:实时建议草案和分析
  • 豁免线分析:使用趋势数据查找热门皮卡
  • 职位标准化:采用位置调整评分的智能FLEX决策
  • 速率限制和缓存:高效使用API,内置优化功能

快速开始

先决条件

  • Python 3.9+
  • 克劳德桌面版
  • 雅虎梦幻体育账号
  • 雅虎开发者应用程序凭据

安装

  1. 克隆存储库:
git clone https://github.com/carterfawson/fantasy-football-mcp.git
cd fantasy-football-mcp
  1. 安装依赖项:
pip install -r requirements.txt
  1. 配置API凭据:

    • 雅虎API:关注 YAHOO_SETUP.md 详细设置
    • Reddit API (可选):请参见 REDDIT_SETUP.md 玩家情绪分析
    • 复制 .env.example 到 .env
    • 添加您的API凭据
    • 运行身份验证: python utils/setup_yahoo_auth.py
  2. 配置Claude桌面:

    • 添加MCP服务器配置(请参阅 安装.md)
    • 重新启动克劳德桌面

可用的MCP工具

联赛管理

  • ff_get_leagues -列出你所有的梦幻足球联赛
  • ff_get_league_info -获取详细的联盟信息
  • ff_get_standings -查看当前排名

团队管理

  • ff_get_roster -获取你的球队名单
  • ff_get_matchup -通过对手分析查看比赛详情
  • ff_get_opponent_roster -获取对手的名单以进行比赛计划
  • ff_get_opponent_roster_comparison -详细的名册比较和见解
  • ff_get_optimal_lineup -获取AI阵容推荐

🆕 加强名册管理

  • ff_set_lineup -设置你的首发阵容(通过智能位置变化检测增强)
  • ff_change_player_position -将一名球员移动到另一个位置(比更换完整阵容更安全)
  • ff_add_player -添加来自自由球员或豁免线的球员(功能齐全)
  • ff_drop_player -从你的名单中删除球员
  • ff_get_waiver_status -检查待处理的豁免索赔和交易的状态

玩家发现

  • ff_get_players -浏览可用玩家
  • ff_get_waiver_wire -查找顶级豁免提货
  • ff_get_draft_rankings -获取初稿排名

起草和管理

  • ff_get_draft_results -查看结果草稿
  • ff_get_draft_recommendation -获取实时草稿建议
  • ff_refresh_token -刷新雅虎访问令牌

项目结构

fantasy-football-mcp-public/
├── fantasy_football_multi_league.py  # Main MCP server
├── src/                               # Core modules
│   ├── agents/                        # Specialized agents
│   ├── models/                        # Data models
│   ├── strategies/                    # Lineup strategies
│   └── utils/                         # Utility functions
├── utils/                             # Authentication utilities
├── config/                            # Configuration
└── requirements.txt                   # Dependencies

配置

看 安装.md 有关详细的设置说明。

安全

  • 永不承诺 .env 文件或API凭据
  • 看 安全.md 安全策略
  • 定期轮换访问令牌

贡献

看 贡献.md 作为指导方针。

许可证

麻省理工学院-参见 许可证 文件

支持

有关问题或疑问,请使用 GitHub问题 页面。