balldontlie-mcp 是一个 MCP(Model Context Protocol)服务器实现,集成 Balldontlie API,为 NBA(美国职业篮球联赛)、NFL(美国职业橄榄球联盟)和 MLB(美国职业棒球大联盟)提供球员、球队和比赛信息。该实现由第三方提供,与 balldontlie.io 无官方关联。
主要能力:
- 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 工具的比赛 id。
- schedule_generator:给定一个联赛(NBA、MLB、NFL)、起始日期和结束日期,在 Claude Desktop 中生成交互式赛程。
使用方式:
安装该 MCP 服务器后,可以向 Claude 或其他 LLM 提出相关问题。安装前需要获取 API Key:在 Balldontlie.io 注册账号,免费计划即可满足此 MCP 服务器的需求。
安装方式包括:
- 使用桌面扩展(DXT)安装:从 Releases 下载 dxt 文件,用 Claude Desktop 打开它,或者转到 File -> Settings -> Extensions,将 .DXT 文件拖到窗口中安装。
- 通过 Smithery 安装:通过 Smithery 为 Claude Desktop 自动安装 balldontlie-mcp。
- 与 Claude Desktop 配合使用:将配置添加到 claude_desktop_config.json 中。
- 与 LibreChat 配合使用。
还提供托管部署,可在 Fronteir AI 上使用。
适用场景:需要通过 LLM 查询 NBA、NFL、MLB 的球队、球员、比赛信息或生成赛程时,可使用该 MCP 服务器接入 Balldontlie API 获取数据。
限制:该库与 balldontlie.io 无官方关联,是第三方实现的 balldontlie api 与 MCP Server。项目采用 MIT 许可证,可自由使用、修改和分发,具体条款见 LICENSE 文件。关于 API 免费计划的更多限制、是否涉及收费或价格、以及具体使用效果,资料中暂未提供。