footballstack-mcp

MCP 服务器，用于 FootballStack 足球数据 API。为 LLM 客户端提供真实的足球数据——赛程、积分榜、阵容、实时事件、带球场坐标的射门级 xG 以及模型推导的公平赔率——而不是幻觉般的比分。

12 个工具，1 个提示。Node ≥ 20，无需构建步骤。

安装

npx footballstack-mcp

在环境中设置你的 API 密钥。免费套餐：每月 1,000 次请求。在 footballstackapi.com/sign-in 获取密钥。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "footballstack": {
      "command": "npx",
      "args": ["-y", "footballstack-mcp"],
      "env": { "FOOTBALLSTACK_API_KEY": "fs_live_..." }
    }
  }
}

Cursor / Windsurf / 任何 stdio MCP 客户端

相同的代码块，放在该客户端的 MCP 配置文件中。

Related MCP server: worldcup-ai-forecaster

工具

提示：scout_team_form — 解析球队，获取其最近 5 场比赛，读取结果背后的 xG。

从 footballstack_search 开始 来解析 ID。猜测 ID 会浪费配额：404 和空结果与其他请求一样计费。

覆盖范围，如实说明

目录列出了 75 个比赛。深度并不均匀，目录比深度覆盖更广。

• 最深： Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României

• 扩展欧洲： Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership

• 仅历史/分析： Premier League, La Liga, Serie A, Ligue 1（xG 来自 Understat）

调用 footballstack_competitions 并在构建之前检查你的联赛。

配额行为

• 免费：每月 1,000 次请求，每分钟 10 次。开发者 $9/月：每月 10,000 次请求，每分钟 60 次，包括 xG、射门图、阵容、实时事件和公平赔率。专业版 $29/月：每月 50,000 次，每分钟 180 次。

• 无超额计费。 配额用完后 API 返回 429；此服务器将其显示为 quota_or_rate_limit 错误，而不是空结果。

• 配额在每月 1 日 UTC 重置。

• 每个请求都计费，包括 404 和空结果。

何时不适合使用此工具

• 跨多个比赛的高频实时轮询。 月度配额不适合这种场景——其他地方的按天或按秒计费方案会更便宜。

• 上述深度覆盖列表之外的联赛。

• 你需要合同 SLA、正常运行时间积分或指定的支持联系人。 这些价格不提供。

开发

npm install
npm run smoke   # boots the server over stdio, lists tools, calls health

npm run smoke 无需 API 密钥即可运行：footballstack_health 返回实时状态，而需要密钥的工具返回可读的 missing_api_key 错误，以便你区分“未配置”和“故障”。

MIT.