Balldontlie Mcp

Balldontlie Mcp

🚀 BallDontlie MCP 服务器

本项目是一个集成 Balldontlie API 的 MCP 服务器实现,能够提供关于 NBA、NFL 和 MLB 球员、球队和比赛的信息,为体育数据的获取和处理提供了便利。

🚀 快速开始

在使用本服务器前,你需要先获取 API 密钥并完成安装与配置。以下是详细步骤:

获取 API 密钥

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

安装说明

使用以下命令安装:

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

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

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

✨ 主要特性

工具

  • 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 中生成一个交互式日程安排。 claude desktop 示例

💻 使用示例

基础用法

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 许可证。

📚 详细文档

免责声明

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

  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-22 01:51

相似服务问题