Balldontlie MCP Server

Balldontlie MCP 服务

一个集成了 Balldontlie API 的 MCP 服务实现，用于提供 NBA、NFL 和 MLB 的球员、球队和比赛信息。

工具

• get_teams

  • 从以下联赛之一获取球队列表：NBA（National Basketball Association）、MLB（Major League Baseball）、NFL（National Football League）
  • 输入：
    • league（enum ['NBA', 'NFL', 'MLB']）：要获取球队的运动联赛

• get_players

  • 从以下联赛之一获取球员列表：NBA（National Basketball Association）、MLB（Major League Baseball）、NFL（National Football League）
  • 输入：
    • league（enum ['NBA', 'NFL', 'MLB']）：要获取球员的运动联赛
    • firstName（string，可选）：要搜索的球员名字
    • lastName（string，可选）：要搜索的球员姓氏
    • cursor（number，可选）：用于分页的游标

• get_games

  • 从以下联赛之一获取比赛列表：NBA（National Basketball Association）、MLB（Major League Baseball）、NFL（National Football League）
  • 输入：
    • league（enum ['NBA', 'NFL', 'MLB']）：要获取比赛的运动联赛
    • dates（string[]，可选）：获取指定日期的比赛，格式：YYYY-MM-DD
    • teamIds（string[]，可选）：获取指定球队的比赛
    • cursor（number，可选）：用于分页的游标

• get_game

  • 从以下联赛之一获取特定比赛：NBA（National Basketball Association）、MLB（Major League Baseball）、NFL（National Football League）
  • 输入：
    • league（enum ['NBA', 'NFL', 'MLB']）：要获取比赛的运动联赛
    • gameId（number）：来自 get_games 工具的比赛 id

提示词

• schedule_generator

给定一个联赛（NBA、MLB、NFL）、起始日期和结束日期，在 Claude Desktop 中生成交互式赛程。

示例查询

安装此 MCP 服务后，你可以向 Claude 或其他大模型提出如下问题。

Show me today's baseball games.
Can you find football players with the last name Purdy?
How many NBA players have the last name Ming?

配置

获取 API 密钥

1. 在 Balldontlie.io 注册账号
2. 免费套餐足以用于此 MCP 服务

使用桌面扩展（DXT）安装

1. 从 Releases 下载 dxt 文件
2. 使用 Claude Desktop 打开它 或 前往 File -> Settings -> Extensions，将 .DXT 文件拖到窗口中即可安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 balldontlie-mcp：

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

与 Claude Desktop 配合使用

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcp-servers": {
    "balldontlie": {
      "command": "npx",
      "args": [
        "-y",
        "balldontlie-mcp"
      ],
      "env": {
        "BALLDONTLIE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

与 LibreChat 配合使用

mcpServers:
  balldontlie:
    command: sh
    args:
      - -c
      - BALLDONTLIE_API_KEY=your-api-key-here npx -y balldontlie-mcp

许可证

此 MCP 服务基于 MIT 许可证授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。有关更多详细信息，请参阅项目仓库中的 LICENSE 文件。

免责声明

本库与 balldontlie.io 没有官方关联。它是 balldontlie API 的第三方实现，并附带一个 MCP 服务。

托管部署

Fronteir AI 上提供托管部署。