Balldontlie MCP Server 使用说明

项目简介

Balldontlie MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它集成了 Balldontlie API，为大型语言模型 (LLM) 应用提供 NBA, NFL 和 MLB 的体育赛事相关数据。通过此 MCP 服务器，LLM 可以查询球队、球员和比赛信息，从而增强其在体育领域的知识和对话能力。

主要功能点

提供体育数据查询工具: 提供了 'get_teams', 'get_players', 'get_games', 'get_game' 等工具，允许 LLM 查询 NBA, NFL, MLB 的球队、球员和比赛信息。
支持多种体育联盟: 覆盖 NBA (篮球), NFL (橄榄球), MLB (棒球) 三大体育联盟的数据。
数据格式化输出: 返回结构化的文本信息，方便 LLM 理解和使用。
分页支持: 对于数据量较大的查询（如 'get_players', 'get_games'），支持分页功能，通过 'cursor' 参数获取后续数据。

安装步骤

获取 API 密钥: 访问 Balldontlie.io 注册账号并获取 API Key (免费计划即可满足本MCP服务器的需求)。

安装 balldontlie-mcp: 推荐使用 Smithery CLI 进行安装，命令如下：

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

这将自动安装并配置 balldontlie-mcp 服务器。

服务器配置

MCP 客户端（如 Claude Desktop, LibreChat）需要配置才能连接到 balldontlie-mcp 服务器。以下是针对不同客户端的配置示例：

Claude Desktop 配置 (claude_desktop_config.json):

{
  "mcp-servers": {
    "balldontlie": {  // 服务器名称，客户端用此名称引用
      "command": "npx", // 启动命令
      "args": [       // 命令参数
        "-y",
        "balldontlie-mcp"
      ],
      "env": {        // 环境变量
        "BALLDONTLIE_API_KEY": "YOUR API KEY HERE" // 将 YOUR API KEY HERE 替换为你从 Balldontlie.io 获取的 API Key
      }
    }
  }
}

LibreChat 配置 (yaml 配置文件):

mcpServers:
  balldontlie: # 服务器名称，客户端用此名称引用
     command: sh  # 启动命令
     args:        # 命令参数
       - "-c"
       - "BALLDONTLIE_API_KEY=your-api-key-here npx -y balldontlie-mcp" # 将 your-api-key-here 替换为你从 Balldontlie.io 获取的 API Key

注意:

请务必将配置文件中的 '"YOUR API KEY HERE"' 或 '"your-api-key-here"' 替换为您在 Balldontlie.io 申请的 API Key。
'balldontlie' 是您为该 MCP 服务器指定的名称，在客户端调用工具时会用到。
'command' 和 'args' 指定了服务器的启动命令和参数，确保客户端能够正确启动 MCP 服务器。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，即可通过 'balldontlie' 服务器提供的工具查询体育数据。例如，在 Claude 中，您可以指示 Claude 使用 'balldontlie.get_teams' 工具查询 NBA 球队列表，或者使用 'balldontlie.get_game' 工具查询指定比赛的详细信息。

工具列表及描述 (已在仓库的 README.md 中详细列出):

'get_teams': 获取 NBA, NFL 或 MLB 的球队列表。
'get_players': 获取 NBA, NFL 或 MLB 的球员列表，支持按姓名搜索和分页。
'get_games': 获取 NBA, NFL 或 MLB 的比赛列表，支持按日期、赛季、球队 ID 和分页查询。
'get_game': 获取指定 ID 的 NBA, NFL 或 MLB 比赛的详细信息。

LLM 可以根据用户的问题，选择合适的工具并调用，从而获取并利用体育数据信息。

关键词