Sleeper MCP (sleeper-mcp)

“Sleeper Fantasy Football MCP Server” 可以翻译为：“梦幻足球冷门球员管理控制面板服务器”。不过，这里的“MCP”在常规语境下可能是一个特定领域或内部使用的缩写，如果它在该上下文中有特定的含义或是一个专有名词，那么翻译时可能需要保留原样或根据具体上下文进行适当调整。但基于一般理解，“MCP”在这里被解释为“管理控制面板”（Management Control Panel）的缩写，以符合中文表达习惯

](https://badge.fury.io/js/sleeper-mcp) ](https://npmjs.org/package/sleeper-mcp)  ](https://nodejs.org/en/)

一个全面的模型上下文协议（MCP）服务器，用于与Sleeper梦幻足球平台集成。该服务器使像Claude这样的AI助手能够执行高级梦幻足球分析，并提供策略建议。

📦 安装

# Install globally (recommended)
npm install -g sleeper-mcp

# Or use with npx (no installation needed)
npx sleeper-mcp

🎯 这个服务器能做什么？

📊 联赛管理

• 用户信息潜在客户档案和联盟会员资格
• 联赛详情得分设置、阵容位置、球队概览
• 当前对阵情况谁在对阵谁，比分，阵容

🏈 球员分析

• 球员搜索在Sleeper数据库中查找任何NFL球员
• 热门玩家最热门的弃权名单签约球员
• 伤情状况当前伤员报告及网络调研结果
• 球员对比针对贸易决策的直接对比分析

🧠 基于人工智能的推荐

• 阵容分析自动启动/停止建议
• 放弃连线提示（或：放弃连线技巧）个性化的取货建议
• 对阵策略对手分析与制胜策略
• 交易追踪关注联赛活动及趋势

🚀 快速入门

1. 安装

选择以下安装方法之一：

选项A：全局安装NPM（推荐）

npm install -g sleeper-mcp

选项B：使用npx（无需安装）

npx sleeper-mcp

选项C：本地开发

git clone https://github.com/yourusername/sleeper-mcp.git
cd sleeper-mcp
npm install
npm run build

2. Claude桌面配置

对于全局安装或使用 npx：

{
  "mcpServers": {
    "sleeper-mcp": {
      "command": "sleeper-mcp",
      "args": [],
      "env": {}
    }
  }
}

对于 npx（另一种选择）：

{
  "mcpServers": {
    "sleeper-mcp": {
      "command": "npx",
      "args": ["sleeper-mcp"],
      "env": {}
    }
  }
}

用于本地开发：

{
  "mcpServers": {
    "sleeper-mcp": {
      "command": "node",
      "args": ["/full/path/to/sleeper-mcp/dist/index.js"],
      "env": {}
    }
  }
}

3. 测试

npm test
npm run test:coverage  # Show detailed code coverage

🧪 测试覆盖率

该服务器包含全面的测试，涵盖：

✅ 核心基础设施（100%）

• MCP协议服务器初始化和工具注册
• 错误处理无效的工具和格式错误的请求
• JSON-RPC（JSON远程过程调用）适当的请求/响应格式化

API 集成（65%）

• 基本APINFL状态，球员搜索，热门球员
• 用户管理无效的用户处理
• 联赛数据无效联赛ID处理
• 缓存系统清除缓存确认逻辑

✅ 边界情况与验证（90%）

• 空数组优雅处理空播放器列表
• 缺少参数必填字段验证
• 无效的ID处理不存在的用户/联赛/球员情况
• 参数验证类型检查和边界测试

📊 实际覆盖指标

File Coverage:   55.13% statements | 62.36% branches | 35.52% functions
Test Results:    13/13 passing (100%)
Tool Coverage:   8/19 tools tested (42%)
Edge Cases:      ~90% covered

Handler Functions: 27.35% (core logic)
Tools Registry:    93.06% (tool definitions)  
Sleeper Client:    51.21% (API integration)
Server Core:       100% (MCP protocol)

命令：

npm test              # Run all tests
npm run test:coverage # Show detailed coverage report
npm run coverage      # Alias for test:coverage

关键测试场景：

• 服务器启动和MCP握手
• 基本API功能，使用真实数据
• 无效输入处理和错误响应
• 缓存管理与确认流程
• 参数验证和类型检查

🎮 立即开始

与克劳德开启对话并尝试：

"Show me my current lineup against my opponent this week"
"Which players are questionable this week and should I replace them?"
"Give me waiver wire recommendations based on trends"

🛠️ 可用工具

联赛管理

• get_user_info - 获取用户信息
• get_user_leagues - 获取用户的所有联赛信息
• get_league_info - 特定联赛的详细信息
• get_league_rosters - 联赛中所有球队的名单
• get_league_users - 联赛中的所有用户/管理者

对阵分析

• get_current_matchups - 本周对阵情况
• get_matchup_details - 详细的对战信息
• get_nfl_state - 当前NFL状态（周数，赛季）

玩家工具

• search_players - 在数据库中搜索球员
• get_trending_players - 热门新增/退出球员
• get_player_details - 详细的球员信息
• compare_players - 球员一对一比较

分析与建议

• analyze_lineup - 基于人工智能的阵容分析
• research_player_status - 对球员状态进行网络调研
• get_waiver_suggestions - 替补球员（ waiver wire 上的）推荐名单
• get_start_sit_advice - 具体的起跑/坐姿建议
• get_transactions - 最近的联赛交易

📋 示例工作流程

每周准备

1. 查找您的用户信息： get_user_info 使用您的Sleeper用户名
2. 获取您的联赛： get_user_leagues 使用您的用户ID
3. 分析当前对阵形势： get_matchup_details 为你的联赛（或联盟）
4. 检查受伤球员： research_player_status 对于可疑球员
5. 查找豁免接送点: get_waiver_suggestions 为了改进

贸易分析

1. 比较球员: compare_players 用于贸易目标
2. 研究现状： research_player_status 因伤势担忧
3. 分析影响： analyze_lineup 模拟贸易影响

🏆 主要特点

• 无需API密钥 使用Sleeper的公开API
• 智能缓存 - 玩家数据缓存24小时
• 尊重速率限制 - 处理Sleeper每分钟1000次的调用限制
• 全面的错误处理 - 强大的错误恢复能力
• 网络研究整合 - 自动伤情报告研究
• 个性化推荐 - 所有建议均根据您的特定联赛量身定制

📖 文档

• SETUP.md（文件名，可译为“设置说明.md”或保持原样，具体取决于上下文和使用习惯） - 详细的安装和配置指南
• \EXAMPLES.md\ 翻译为中文是：“示例.md”（其中，\.md\ 是 Markdown 文件格式的扩展名，通常表示该文件是一个使用 Markdown 语言编写的文档） - 全面的使用示例和场景
• 内联文档 - 完全注释的代码库

⚡ 技术细节

• TypeScript 为了类型安全
• 佐德 用于输入验证
• MCP SDK（MCP软件开发工具包） 用于克劳德（Claude）的集成
• 只读API - 无法修改阵容（休眠者限制）
• 实时数据 - 始终提供最新信息

🔧 开发

对于用户

# Install globally
npm install -g sleeper-mcp

# Or use directly
npx sleeper-mcp

对于贡献者

# Clone the repository
git clone https://github.com/yourusername/sleeper-mcp.git
cd sleeper-mcp
npm install

# Development with hot reload
npm run dev

# Build for production
npm run build
npm start

# Watch mode (automatic rebuilding)
npm run watch

# Run tests
npm test
npm run test:coverage

⚠️ 局限性

• Sleeper API是只读的（无法修改阵容）
• 速率限制：每分钟最多1000次API调用
• 玩家数据自动缓存（24小时刷新）

📄 许可证

麻省理工学院许可证

🤝 贡献（或“参与贡献”）

此服务器可通过以下方式扩展：

• 附加的Sleeper API端点
• 增强的分析与建议
• 与其他幻想平台的集成
• 历史数据分析

______________________________________________________________________

用AI驱动的分析主宰你的幻想联盟！ 🏆