Bzzoiro MCP：连接 Gemini CLI 查询足球数据

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Bzzoiro Sports Data、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Bzzoiro Sports Data + Gemini

来自 Bzzoiro Sports Data 的足球数据：联赛、积分榜和球员排行榜、赛程和实时比分、首发阵容、进球和比赛统计、球队、阵容名单和近期状态、球员及其每场比赛统计、主教练、电视转播，以及基于模型的比赛展望。免费 API 令牌。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

BZZOIRO_API_KEY

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个免费的 Bzzoiro Sports Data 账号：足球数据不需要付费套餐。

1. 在 sports.bzzoiro.com/register 免费注册，并从账号页面复制 API 令牌。
2. 把它粘贴到 BZZOIRO_API_KEY。只粘贴令牌本身，前面不要加 Token 一词：连接器会自动以 Authorization: Token <key> 的形式发送。
3. 安装连接器，并运行 bzzoiro_list_leagues 检查连接。

Cloud 和自托管的方式相同：连接器只需要你的令牌。

限额内免费：在 Bzzoiro 公布的限额内，足球数据免费：每个账号每天 7,500 次请求（UTC 午夜重置），另有约每秒 25 次请求的突发限额。

实时比分：bzzoiro_list_live_matches 涵盖从开球前五分钟到终场哨响后不久的比赛。Bzzoiro 大约每 30 秒刷新一次数据；查询间隔不要短于 10 秒。

首发阵容：大约在开球前一小时确认。在此之前，lineup_status 会表明阵容是由 Bzzoiro 的模型推算的。

ID：联赛、赛季、球队、比赛（在 API 中称为 events）、球员和主教练都有整数 ID。AI 用 bzzoiro_list_leagues、bzzoiro_list_league_seasons、bzzoiro_list_teams、bzzoiro_list_players 和 bzzoiro_list_managers 查找它们；比赛 ID 来自 bzzoiro_list_matches、bzzoiro_list_live_matches 和 bzzoiro_list_team_fixtures。

时间和分页：所有时间均为 UTC（ISO 8601），引用开球时间前请先换算。日期筛选接受 YYYY-MM-DD 或完整时间戳。列表用 limit（最多 200）和 offset 分页。不指定日期时，bzzoiro_list_team_fixtures 和 bzzoiro_list_broadcasts 覆盖从三小时前到七天后的范围。

比赛展望：bzzoiro_get_match_outlook 返回 Bzzoiro 基于模型的比赛展望，例如可用于赛前前瞻。它是统计估计，绝非确定结果。

常见错误：401 表示 Bzzoiro 拒绝了令牌：请从账号中重新复制，并只粘贴令牌本身。403 表示该令牌的套餐不包含此资源：足球免费，其他运动需要付费套餐。429 且为 taster_exhausted 表示当天配额已用完；为 rate_limited 时放慢一秒即可。400 表示筛选条件未知：Bzzoiro 会拒绝而不是忽略它。

仅限足球：Bzzoiro 的其他运动不在此连接器范围内。数据可能延迟或不完整；依赖之前请先核实。

可读取的内容：联赛和杯赛及其赛季和阶段；积分榜，以及进球、助攻、黄牌、红牌和犯规排行榜；包含开球时间、状态、比分、轮次和阶段的赛程与赛果；带比分和比赛分钟的进行中比赛；每场比赛的首发阵容和阵型、含进球者和助攻者的进球、红黄牌、换人和 VAR 判罚、含 xG 的球队统计、球员统计和交锋记录；包含阵容名单、伤病和预计复出时间的球队及其近期状态；球员资料和逐场统计；主教练的战绩和战术特点；转播某场比赛的电视频道；以及 Bzzoiro 基于模型的比赛展望。

只读：所有工具都只读取数据，因此无需确认任何操作，安装时也没有关闭任何工具。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list）— anythingmcp 应显示为已连接。
4. 开始输入提示 — Gemini CLI 现在可以调用 Bzzoiro Sports Data 的工具。

可用工具

示例提示

• “给我看英超当前的积分榜和射手榜前 10 名。”
• “本菲卡下一场比赛是什么时候？葡萄牙有哪些电视频道转播？”
• “现在有哪些意甲比赛正在进行？比分多少，谁进了球？”
• “皇家马德里下一场比赛的首发阵容确认了吗？给我看阵型和首发十一人。”
• “比较国际米兰和尤文图斯最近 10 场意甲比赛的状态，并逐场列出劳塔罗·马丁内斯本赛季的进球和助攻。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude