Thesportsdb

@pipeworx/thesportsdb

TheSportsDB MCP — 覆盖 50 多个联赛的体育目录：球队、球员、赛事、场馆和联赛积分榜。免费套餐提供公共密钥。

属于 Pipeworx — 一个将 AI Agent 连接到 1684 多个实时数据源的 MCP 网关。

工具

• list_sports() / list_leagues(sport?, country?)
• search_teams(query)、get_team(team_id)、league_teams(league_id)
• search_players(query) / get_player(player_id)
• team_events_last(team_id) / team_events_next(team_id)
• events_by_day(date, sport?, league?)
• league_table(league_id, season?)

身份验证

免费公共套餐使用 API 密钥 3（众所周知，无需注册）。Pipeworx 默认使用此密钥。如需更高的速率限制或额外端点，请前往 https://www.thesportsdb.com/ 注册，并通过 ?_apiKey=<key> 使用自己的密钥。

数据源

https://www.thesportsdb.com/api/v1/json/<apiKey>/

比赛详情（event_detail、event_timeline、event_stats、event_lineup）

这 4 个单场比赛工具可用于核实有关某场比赛的问题：比分和场馆（event_detail）、进球及进球者／助攻者／分钟数，以及红黄牌和换人情况（event_timeline）、逐队统计数据（event_stats），还有首发 11 人和替补球员（event_lineup）。它们都需要 TheSportsDB 的 event_id — 可通过 events_by_day、team_events_last 或 team_events_next 查找。

它们不受高级套餐限制 — 但免费套餐会截断数据

在 2026-09-12 使用免费公共密钥进行的测量显示：这 4 个端点都会返回真实数据，因此无需密钥，也没有任何工具会因缺少密钥而拒绝请求。

免费套餐确实会将每个数组限制为最多 5 行，且不作提示。以 idEvent 2594568（拜仁慕尼黑对阵博德闪耀，最终比分 5-0）为例，时间线返回 5 行，最早一行为第 45 分钟，其中包含 2 个进球 — 上半场的所有进球都缺失。event_stats 返回 5 项统计数据，但不包含射门、角球或控球率。event_lineup 返回 5 名球员。intHomeScoreHT / intAwayScoreHT 返回 null。

因此，对于结算工作负载，支持者密钥很重要 — 重要的是完整性，而不是访问权限。请将其作为 _apiKey 传入。

工具如何告知你

event_timeline 会将它能看到的进球与赛事自身的最终比分进行交叉核对。如果两者不一致，它会返回 complete: false，并附上 goals_in_timeline、goals_in_final_score 以及一条说明，提醒不要据此结算首位进球者或半场结果问题。这是数据遭到截断的证据，而非猜测。event_stats 和 event_lineup 没有等效的不变量，因此当恰好返回 5 行时，它们会报告 complete: null — 这可能是完整的小型结果，也可能是遭到截断的大型结果；仅凭响应无法区分两者。

覆盖范围因赛事而异

如果数据源未覆盖某场比赛，则会返回 found: false 和原因，不会报错，也不会给出错误答案。这些工具会区分上游返回结果相同的两种情况（都是单独的 null）：no_timeline_for_event — 比赛存在，且会返回其名称，但数据源没有该赛事的时间线 — 与 no_data_and_event_unconfirmed，表示无法确认该赛事 ID。对于要结算市场的调用方来说，这两种情况意味着截然相反的结论：“换一个数据源”与“你找错了比赛”。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

https://gateway.pipeworx.io/thesportsdb/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及其他整个网关通用的工具。因此，你看到的工具数量会多于表格所列：目前，单个工具包端点除了列出该工具包自有工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切的范围，并且是当天情况的权威答案。

这是有意为之，并非意外地进行了多路复用。元工具让范围受限的连接也能回答该工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中路由——无需再添加第二个 MCP 服务。目前无法在不加载这些元工具的情况下挂载工具包端点；如果额外的架构信息占用的上下文比路由功能带来的价值更大，不妨只连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

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

两个 URL 都连接到同一个网关和相同的 1684+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点使用 ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你自己的 API 密钥（_apiKey）——我们不会为它代理密钥，因此这里没有无需密钥即可运行的 curl 命令。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/thesportsdb_list_sports。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关帐户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 帐户，也无需往返网关：

{
  "mcpServers": {
    "thesportsdb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-thesportsdb"]
    }
  }
}

或者直接运行，确认它能够启动：

npx -y @pipeworx/mcp-thesportsdb

它通过 stdin/stdout 使用 MCP，并仅为此工具包中的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——这不仅适用于上面的工具包端点，也适用于完整网关：

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT