Skip to main content
Glama
pipeworx-io

mcp-nba

by pipeworx-io

mcp-nba

NBA MCP — 通过 BallDontLie API 获取球员、球队和比赛数据

是 Pipeworx 的一部分 — 一个将 AI 代理连接到 1476+ 实时数据源的 MCP 网关。

工具

工具

描述

search_players

"查找 NBA 球员 [姓名]" / "在 NBA 名单中搜索 [X]" / "[球员] 是否在 NBA 中" — 在 BallDontLie 上按姓名搜索 NBA 球员。返回位置、身高、体重、大学、国家、选秀信息和当前球队。注意:每赛季平均数据(PPG/RPG/APG)和生涯数据不在此响应中 — 这些需要通过 /season_averages 端点使用 BallDontLie 的 ALL-STAR 档位(每月 $9.99,详见 https://www.balldontlie.io/),该端点目前未由 Pipeworx 暴露。免费版 _apiKey 可在此工具上使用。

get_player

按 BallDontLie ID 直接查找单个 NBA 球员。⚠️ 受档位限制:/players/{id} 端点需要 ALL-STAR 档位(每月 $9.99)或更高;免费版 _apiKey 会收到 403 错误,提示 "No approval received"。search_players 在免费档位即可覆盖相同的球员元数据(姓名/位置/身高/体重/球队),因此除非你已有付费的 BallDontLie 密钥,否则优先使用该工具。

get_teams

获取全部 30 支 NBA 球队,包含全名、缩写、赛区和分区。用于查找球队信息或为 get_games 查询做准备。需要免费的 BallDontLie API 密钥。

get_games

获取某个赛季的 NBA 比赛(例如 2023、2024)。返回比赛日期、状态、对阵球队以及最终或实时比分。需要免费的 BallDontLie API 密钥。

Related MCP server: NBA MCP Server

快速开始

添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):

{
  "mcpServers": {
    "nba": {
      "url": "https://gateway.pipeworx.io/nba/mcp"
    }
  }
}

这个端点实际提供什么

位于 https://gateway.pipeworx.io/nba/mcp 的 tools/list 返回上表中的工具,外加共享的 Pipeworx 元工具 — ask_pipeworx、discover_tools、search_within、remember/recall 以及其余网关级工具集。因此你看到的工具数量大于此表:单包端点当前会列出约 30 个共享工具,以及该包自身的工具。连接的 initialize 响应会说明其确切范围,并且是给定日期下的权威答案。

这是有意为之,并非偶然的多路复用。元工具的作用是让受限连接能够回答该包未覆盖的问题 — 通过 ask_pipeworx 在整个目录中路由 — 而无需你添加第二个 MCP 服务器。目前没有办法在缺少这些元工具的情况下挂载包端点;如果额外 schema 消耗的上下文比路由带来的价值更多,请直接连接一次完整网关,而不是连接多个包端点。

或者连接到完整的 Pipeworx 网关,以直接列出每个包的工具,而不仅仅是这一个包的:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都通向同一个网关和相同的 1476+ 数据源。唯一的区别是直接列出的是哪个包的工具;ask_pipeworx 从两者中的任意一个都能访问到所有这些工具。

与 ask_pipeworx 一起使用

除了直接调用工具,你还可以用自然语言提问 — 这既适用于上面的包端点,也适用于完整网关:

ask_pipeworx({ question: "your question about Nba data" })

网关会自动选择正确的工具并填充参数。

更多

许可证

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB.
    4
    50 npm
    26
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server that enables LLMs to retrieve NBA data including player stats, team information, game logs, and league standings through the nba_api library.
    10
    1
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables querying basketball data including players, games, season averages, and stats from the balldontlie.io API.
    147 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides live NHL data from the official NHL API, enabling users to fetch standings, scores, schedules, and player statistics.
    12 npm
    MIT