AI导哈

梦幻足球数据分析服务

Sleeper梦幻足球的模型上下文协议服务器，提供交易分析、比赛预览和豁免推荐等高级功能。

  • by anthonybaldwin
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 anthonybaldwin/sleeper-api-mcp

使用说明

Sleeper API MCP 服务器

一个针对Sleeper梦幻足球的综合模型上下文协议（MCP）服务器，具备先进的交易分析、对阵预览和免签推荐功能。

特点/特性

核心功能

  • 获取用户信息和联赛信息
  • 访问联赛详情、球员名单和对阵情况
  • 查看交易和热门玩家
  • 获取当前NFL赛季状态
  • 查询玩家详情

高级功能

  • 贸易分析分析贸易风险、价值及仓位影响
  • 比赛前瞻获取即将到来的比赛预测及获胜概率
  • 豁免建议根据球队需求获取个性化的替补球员建议
  • 阵容优化分析并优化你的首发阵容
  • 自由球员搜索按位置查找可用球员

可用工具

基本工具

  • get_user - 通过用户名获取Sleeper用户信息
  • get_user_leagues - 获取特定用户的全部联赛信息
  • get_league - 通过联赛ID获取联赛信息
  • get_league_rosters - 获取联盟中的所有球队名单
  • get_league_users - 获取联盟中的所有用户
  • get_matchups - 获取特定周的比赛对阵情况
  • get_transactions - 获取特定周的交易记录
  • get_trending_players - 获取热门玩家（新增/离开）
  • get_player_details - 获取特定球员的详细信息
  • get_nfl_state - 获取当前NFL赛季的状态

高级工具

  • analyze_trade - 分析两队之间的交易风险和价值
  • preview_matchup - 预览即将进行的比赛并查看预测
  • get_waiver_recommendations - 获取免签名单建议
  • get_free_agents - 获取可用的自由球员
  • analyze_lineup - 分析并优化阵容
  • get_player_projections - 获取一周的球员预测数据

安装

快速入门（推荐）

  1. 下载可执行文件 为您的平台（提供/来自……的） 最新发布版：

    • macOS（Apple Silicon）: sleeper-mcp-macos-arm64
    • macOS（英特尔版）： sleeper-mcp-macos-x64
    • Linux（x64）： sleeper-mcp-linux-x64
    • Linux（ARM64架构）： sleeper-mcp-linux-arm64
    • Windows： sleeper-mcp-windows-x64.exe

  2. 使其可执行 （仅限 macOS/Linux）：

chmod +x sleeper-mcp-macos-arm64  # or whichever file you downloaded
  1. 配置Claude桌面版：

编辑您的Claude桌面配置文件：

  • macOS（发音为/mækɒs/，中文常称为“麦奥斯”或直接使用英文原名）： ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "sleeper": {
      "command": "/path/to/sleeper-mcp-macos-arm64",
      "env": {
        "SLEEPER_USERNAME_A": "your_username",
        "SLEEPER_LEAGUE_A_ID_1": "1234567890123456789"
      }
    }
  }
}

替换 /path/to/sleeper-mcp-macos-arm64 使用你下载的可执行文件的实际路径，并用你的Sleeper用户名和联盟ID更新环境变量。

  1. 重启Claude桌面版

配置

多用户/联赛支持

该服务器支持多个用户和联盟。请将它们添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "sleeper": {
      "command": "/path/to/sleeper-mcp",
      "env": {
        "SLEEPER_USERNAME_A": "first_username",
        "SLEEPER_LEAGUE_A_ID_1": "league_id_1",
        "SLEEPER_LEAGUE_A_ID_2": "league_id_2",
        "SLEEPER_USERNAME_B": "second_username",
        "SLEEPER_LEAGUE_B_ID_1": "another_league_id"
      }
    }
  }
}

服务器将根据您查询中的上下文线索，智能地检测出您所指的是哪个联赛。

使用示例

基本查询

  • “获取用户名为‘johndoe’的Sleeper用户信息”
  • “给我展示2024赛季我参加的所有联赛”
  • “获取当前NFL周数”

贸易分析

  • “分析一笔交易：队伍1给出[球员ID]，换得队伍2的[球员ID]”
  • “这些球员的交易价值差异有多大？”
  • “给我看看这个行业中的受伤风险”

比赛前瞻

  • “预览我在联赛[联赛ID]中的第10周比赛对阵情况”
  • “我这周的获胜概率是多少？”
  • “给我显示两队的预计得分”

“Waiver Wire”可以翻译为“豁免条款”或“放弃条款”，具体取决于上下文和语境。在体育（如美式足球或职业体育联盟）中，有时“waiver wire”特指一种球员交易或转会的机制，即球队可以通过放弃某名球员的签约权来从“豁免名单”（waiver wire）中获取另一名球员。这种情况下，可以翻译为“豁免名单”或“放弃名单（用于球员交易）”。但一般情况下，若无特定语境，翻译为“豁免条款”或“放弃条款”即可

  • “为我的团队获取豁免建议”
  • “给我看看通过放弃条款（waivers）可用的热门跑卫（RBs）”
  • “我的豁免优先级和预算是什么？”

阵容优化

  • “分析我第10周的阵容”
  • “我应该对阵容做出任何调整吗？”
  • “我在FLEX应该从哪里开始呢？”

贸易分析功能

贸易分析工具评估：

  • 价值平衡计算球员的相对价值
  • 受伤风险交易中用旗帜标记受伤球员
  • 位置影响力分析贸易如何影响深度
  • 团队记录考虑球队排名
  • 建议提供贸易裁决

发展

对于希望修改代码的开发者：

先决条件

设置

# Clone the repository
git clone https://github.com/anthonybaldwin/sleeper-api-mcp.git
cd sleeper-api-mcp

# Install dependencies
bun install

# Create .env file with your config (optional, for development)
cp .env.example .env
# Edit .env with your Sleeper credentials

# Run in development mode
bun run dev

# Build executable
bun run build

构建命令会创建一个独立的可执行文件（sleeper-mcp 或者 sleeper-mcp.exe（该文件）包含了所有依赖项。

API 参考

这个服务器使用公开的Sleeper API v1。无需进行身份验证。如需更多详情，请参阅 Sleeper API 文档.

笔记

  • 来自Sleeper API的实时数据
  • 从Sleeper的预测端点获取的预测数据
  • 当前周数据的智能缓存（5分钟缓存）
  • 设置速率限制以防止API限速
  • 支持PPR（标准球员）、Half-PPR（半标准球员）和标准计分规则

相关 MCP