Sleeper 🏈 Model Context Protocol Server

Sleeper 🏈 Model Context Protocol 服务

Model Context Protocol（MCP）服务，为用户提供访问其 Sleeper 联盟历史表现的途径。此服务还提供当前赛季的详细信息。

关键文件

index.ts

• 定义了下面列出的 15 个 MCP 工具：
  • get-current-nfl-week - 当前 NFL 周信息
  • get-trending-players - 全联盟新增／被移除最多的球员
  • get-user-roster-trending-players - 用户阵容中的热门球员
  • get-league-names-for-user - 某个用户名所属的所有联盟
  • get-league-settings - 联盟常规配置
  • get-league-playoff-schedule - 季后赛结构和时间安排
  • get-league-scoring-settings - 详细计分规则
  • get-league-roster-settings - 首发阵容要求
  • get-matchup-details - 指定周的正面对决摘要
  • get-matchup-starters - 获取指定对决中两支队伍的首发球员
  • get-league-playoff-history - 历史季后赛结果
  • get-matchup-bench - 获取指定对决中两支队伍的替补球员
  • get-bench-starter-analysis - 指定对决的阵容优化分析
  • get-season-head-to-head - 跨赛季的完整对战记录
  • get-league-playoff-bracket - 获取联盟的季后赛对阵表

utils/processors.ts

• 此文件负责需要查询历史数据的工具的实现细节。
• 我们定义了一个名为 processLeagueDataByYear 的函数，用于访问历史联盟信息。
  • 这非常重要，因为 Sleeper API 不支持直接访问历史联盟数据，因此必须通过追踪 previous_league_id 引用手动构建联盟链。
  • 此函数允许客户端提供年份范围，例如 "2022"、"2022-2024"、"2020, 2022, 2024"。
  • 使用此函数的每个工具都需要提供一个处理器函数，根据所访问的端点类型格式化相应年份的输出。

utils/api.ts

• 包含与 Sleeper API 通信所需的 API 调用。

开始使用

前置条件：

• Node.js
• npm
• Claude 桌面应用

安装：

1. 克隆仓库

   git clone https://github.com/asotiropusc/sleeper-mcp-server.git
   cd sleeper-mcp-server
   

2. 安装依赖项

   npm install
   

配置：

要使用此 MCP 服务，必须通过 Claude 配置将其告知 Claude Desktop。打开配置文件：

在 Mac 上：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

在 Windows 上：

code $env:AppData\Claude\claude_desktop_config.json

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "sleeper-fantasy-football": {
      "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/sleeper-mcp-server/node_modules/.bin/tsx",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/sleeper-mcp-server/src/index.ts"
      ]
    }
  }
}