mcp-nba
mcp-nba
NBA MCP — 通过 BallDontLie API 获取球员、球队和比赛数据
是 Pipeworx 的一部分 — 一个将 AI 代理连接到 1476+ 实时数据源的 MCP 网关。
工具
工具 | 描述 |
| "查找 NBA 球员 [姓名]" / "在 NBA 名单中搜索 [X]" / "[球员] 是否在 NBA 中" — 在 BallDontLie 上按姓名搜索 NBA 球员。返回位置、身高、体重、大学、国家、选秀信息和当前球队。注意:每赛季平均数据(PPG/RPG/APG)和生涯数据不在此响应中 — 这些需要通过 /season_averages 端点使用 BallDontLie 的 ALL-STAR 档位(每月 $9.99,详见 https://www.balldontlie.io/),该端点目前未由 Pipeworx 暴露。免费版 _apiKey 可在此工具上使用。 |
| 按 BallDontLie ID 直接查找单个 NBA 球员。⚠️ 受档位限制:/players/{id} 端点需要 ALL-STAR 档位(每月 $9.99)或更高;免费版 _apiKey 会收到 403 错误,提示 "No approval received"。search_players 在免费档位即可覆盖相同的球员元数据(姓名/位置/身高/体重/球队),因此除非你已有付费的 BallDontLie 密钥,否则优先使用该工具。 |
| 获取全部 30 支 NBA 球队,包含全名、缩写、赛区和分区。用于查找球队信息或为 get_games 查询做准备。需要免费的 BallDontLie API 密钥。 |
| 获取某个赛季的 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
This server cannot be deployed
Maintenance
Related MCP Connectors
Provides access to live sports data and analytics from BALLDONTLIE: The Sports API
Live and historical NBA/NFL/NHL data — fantasy bots, content sites, betting research.
NBA, WNBA and college basketball data: play-by-play, shot locations, box scores, odds. REST and MCP.
Provides easy access to MLB, Baseball Savant, Statcast, and Fangraphs baseball data. Query detaile…
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB.450 npm26MIT
- FlicenseAqualityDmaintenanceA 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.101-
- AlicenseNot gradedqualityBmaintenanceEnables querying basketball data including players, games, season averages, and stats from the balldontlie.io API.147 npmMIT
- AlicenseNot gradedqualityBmaintenanceProvides live NHL data from the official NHL API, enabling users to fetch standings, scores, schedules, and player statistics.12 npmMIT