🚀 BallDontlie MCP 服务器

这是一个集成 Balldontlie API 的 MCP 服务器实现，能够提供关于 NBA、NFL 和 MLB 球员、球队和比赛的信息，助力用户轻松获取体育赛事相关数据。

✨ 主要特性

本服务器提供了一系列实用工具，用于获取体育赛事的相关信息：

• get_teams
  • 功能：获取指定联赛的球队列表。
  • 输入：
    • league（枚举 ['NBA', 'NFL', 'MLB']）：要获取球队的体育联盟。
• get_players
  • 功能：获取指定联赛的球员列表。
  • 输入：
    • league（枚举 ['NBA', 'NFL', 'MLB']）：要获取球员的体育联盟。
    • firstName（字符串，可选）：要搜索的球员的姓。
    • lastName（字符串，可选）：要搜索的球员的名。
    • cursor（数字，可选）：分页游标。
• get_games
  • 功能：获取指定联赛的比赛列表。
  • 输入：
    • league（枚举 ['NBA', 'NFL', 'MLB']）：要获取比赛的体育联盟。
    • dates（字符串数组，可选）：获取特定日期的比赛，格式为 YYYY - MM - DD。
    • teamIds（字符串数组，可选）：获取指定球队的比赛。
    • cursor（数字，可选）：分页游标。
• get_game
  • 功能：获取某个特定联赛中的某场具体比赛。
  • 输入：
    • league（枚举 ['NBA', 'NFL', 'MLB']）：要获取比赛的体育联盟。
    • gameId（数字）：从 get_games 工具获得的比赛编号。

💡 提示

• schedule_generator 根据给定的联赛（NBA、MLB、NFL）、开始日期和结束日期，在 Claude Desktop 中生成一个交互式日程安排。

📦 安装指南

获取 API 密钥

1. 在 Balldontlie.io 注册并登录。
2. 生成 API 密钥。

安装命令

使用以下命令安装：

npx -y @smithery/cli install @mikechao/balldontlie-mcp

配置文件

在 balldontlie-mcp.config.js 文件中进行配置：

module.exports = {
  // API 密钥在此处配置
}

💻 使用示例

基础用法

const { balldontlieMCP } = require('@mikechao/balldontlie-mcp');

// 获取球队列表示例
balldontlieMCP.getTeams({ league: 'NBA' })
  .then(teams => console.log(teams))
  .catch(error => console.error('Error:', error));

// 获取球员列表示例
balldontlieMCP.getPlayers({ league: 'NFL', firstName: 'John', lastName: 'Doe' })
  .then(players => console.log(players))
  .catch(error => console.error('Error:', error));

📄 许可证

本项目采用 MIT License 许可证。

⚠️ 免责声明

该项目与任何第三方服务或公司无关，仅为学习和研究目的而开发。