梦幻橄榄球数据协议服务器

一个提供用户历史表现数据和当前赛季详情的梦幻橄榄球数据协议服务器。

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

使用说明

沉睡者🏈 模型上下文协议服务器

一种模型上下文协议(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 这便于访问历史联赛信息。
    • 这是至关重要的,因为API睡眠者不提供对历史联盟数据的直接访问,因此必须通过以下方式手动构建联盟链 previous_league_id 参考文献
    • 此功能允许客户端提供年份范围,例如 "2022", "2022-2024", "2020, 2022, 2024".
    • 每个使用此功能的工具都需要提供一个处理器功能,该功能根据访问的端点类型对特定年份的输出进行格式化。

utils/api.ts

  • 容纳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 Config通知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"
      ]
    }
  }
}