用途
openfoot-mcp 是一个面向 AI 客户端的 MCP 服务器，封装 OpenFoot API 的足球数据能力。它让 LLM 客户端能够获取真实的足球数据，而不是依赖模型生成的虚假比分。适用于需要让 AI 助手查询赛程、积分榜、阵容、实时事件、逐射门 xG 和比赛背景信息的场景。
主要能力
服务器提供 15 个工具和 1 个提示词。数据覆盖包括：赛程、积分榜、阵容、实时事件、带球场坐标的逐射门 xG，以及模型推算的公平赔率。提示词示例为 scout_team_form，用于解析球队、拉取最近 5 场比赛并读取结果背后的 xG。使用时应从 openfoot_search 开始解析 ID，因为猜测 ID 会浪费额度——404 和空结果同样按请求计费。
使用方式
需要 Node ≥ 20，无需构建步骤。在环境中设置 API 密钥，密钥可在 openfootapi.com/pricing 获取。支持 Claude Desktop / Claude Code、Cursor / Windsurf 或任何 stdio MCP 客户端，在对应客户端的 MCP 配置文件中使用相同的配置块。npm run smoke 可在没有 API 密钥的情况下运行：openfoot_health 返回实时状态，一个需要密钥的工具会返回可读的 missing_api_key 错误，从而区分“未配置”和“故障”。
适用场景与限制
赛事目录列出 120 项赛事，但深度并不统一。深度覆盖最全的包括：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）。建议先调用 openfoot_competitions 确认目标联赛，再基于其构建。
额度方面：免费层每月 5,000 次请求、每分钟 60 次；Developer 每月 14 美元，25 万次请求、每分钟 100 次，包含 xG、射门图、阵容、实时事件和公平赔率；Pro 每月 39 美元，200 万次请求、每分钟 250 次。无超额计费，额度用尽时 API 返回 429，本服务器将其表现为 quota_or_rate_limit 错误，而非空结果。额度每月 1 日（UTC）重置。每个请求都计费，包括 404 和空结果。
不适合的场景：跨多赛事的高频实时轮询（按月额度不适合，按日或按秒的套餐可能更便宜）；上述深度覆盖列表之外的联赛；需要合同 SLA、正常运行时间补偿或指定支持联系人的场景（当前价格不提供这些）。
