footballcharts-mcp

足球数据 MCP 服务——98 个联赛，涵盖低级别联赛（Football Charts）

English · 简体中文 (简体中文)

为你的 AI 助手提供 98 个联赛（覆盖 44 个国家/地区）的足球数据，包括其他数据源忽略的低级别联赛：积分榜、赛果、赛程、进球时间、公开基准模型，以及来自 football-charts.com 的蒙特卡洛赛季预测。

FC 发布的是概率和公开校准记录，而不是投注建议。 每项模型概率都会在开赛前发布，并在赛后评分；get_track_record 工具会返回这份记录（命中率、Brier 分数、可靠性分组）。

无需密钥

所有工具都无需 API 密钥即可使用，每个 IP 每天 100 次请求（每分钟 20 次）。 免费密钥仅供个人使用，可将限额提升至每天 200 次、每分钟 60 次（同一电子邮箱地址下的所有密钥合并计算）——几秒钟即可获取：

curl -X POST https://footballcharts-backend.onrender.com/api/v1/keys/register/ \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]"}'

密钥（fc_...）只显示一次，请妥善保存。两个套餐均支持全部 98 个联赛 （顶级和低级别联赛、女子联赛）、当前赛季和上一赛季、 模型概率及每日运行 10,000 次的蒙特卡洛预测，不含 投注赔率（历史赔率档案是付费数据集，详见 football-charts.com/data）。

在 claude.ai（网页或移动端）上使用——无需安装

前往 Settings → Connectors → Add custom connector，然后粘贴：

https://mcp.football-charts.com/mcp

这是无需密钥的套餐。使用密钥时，请改为粘贴 https://mcp.football-charts.com/fc_your_key_here/mcp（连接器字段仅接受 URL，因此密钥会包含在其中；密钥为只读、免费且可更换）。支持发送请求头的客户端可使用 POST https://mcp.football-charts.com/mcp，并附带 Authorization: Bearer fc_…。

在 Claude Desktop 上使用——一键安装扩展

从最新版本下载 footballcharts-mcp-<version>.mcpb 并打开；Claude Desktop 会安装它。API 密钥字段可以留空。

在 Claude Desktop 上使用——手动配置

claude_desktop_config.json（自 0.4.0 起，FC_API_KEY 为可选项）：

{
  "mcpServers": {
    "football-charts": {
      "command": "npx",
      "args": ["-y", "footballcharts-mcp"],
      "env": { "FC_API_KEY": "fc_your_key_here" }
    }
  }
}

在 Claude Code 上使用

claude mcp add football-charts -e FC_API_KEY=fc_your_key_here -- npx -y footballcharts-mcp

工具

共 10 个只读工具。每项描述都会说明该工具返回什么。

工具	用途
about_football_charts	数据源概述：涵盖的联赛、不包含的内容、联赛键和赛季格式，以及如何解读概率。
list_leagues	列出所有涵盖的联赛（44 个国家共 98 个），并提供联赛键、国家和可用赛季。
get_league_table	某联赛某赛季的积分榜，包含状态、预期积分和运气类别；可使用 view=luck 或 goals 查看其他排名方式。
get_results	某联赛某赛季已结束的比赛，包含全场和半场比分以及首粒进球时间；可按 team 筛选，并用 last 保留最新的 N 场。
get_fixtures	某联赛即将进行的比赛及模型校准后的概率。
get_match	按 slug 查询一场比赛的完整信息：模型概率、球队评分和进球时间直方图。
get_season_projection	基于 10,000 次模拟得出的冠军、前四和倒数三名概率及积分范围，每日刷新。
get_team	某支球队的赛季信息：积分榜行、比赛记录、每 15 分钟时段的进球数和首粒进球分布。
get_goal_timing	某联赛某赛季所有球队每 15 分钟时段的进球数、进球高峰时段和联赛总计；传入 team 可查询单支球队。
get_track_record	模型公开的校准记录：命中率、Brier 分数和可靠性分组。

该模型是公开的基准模型（Dixon-Coles）。模型经过校准，get_track_record 会展示其表现；但它无法胜过博彩公司市场。覆盖 91 个联赛、从 2020 年起的各博彩公司开盘和收盘赔率，属于付费数据集，详见 football-charts.com/data。

更新日志

• 0.6.0 — 每个回答都会链接到包含相同数据的 football-charts.com 页面（source_url）；get_track_record 返回校准记录（命中率、Brier 分数、可靠性分组）；描述说明每个工具会返回什么，不再包含对模型的指示，并且每个工具的标题也会出现在 annotations.title 中；输出不再包含仅供网站使用的字段 roi_*、profit_* 和 gates；如果缺少预测，get_season_projection 会说明原因，而不是导致输出验证失败。工具和参数仍为原来的 10 个。
• 0.5.0 — 每个工具都增加了 outputSchema 并返回 structuredContent；从使用者角度重写描述（用途 → 何时改用类似工具 → 一个示例）；get_match 不再返回存储内部信息。工具列表约 6k 个 token（原为约 3k）——代价来自架构。两项有意的设计选择：list_leagues 保留 list_ 前缀，因为它枚举所有内容，而不是获取单项内容；league 保持为自由字符串，而不是由 93 个键组成的枚举（枚举会给每个工具增加约 700 个 token；list_leagues 可以通过一次调用解析名称）。架构叶节点不指定类型，确保意外的 null 不会导致调用失败；字段类型与 API 返回值一致（计数和概率为数字、日期为 ISO 格式、比分为 'home:away' 字符串）。
• 0.4.1 — 注册表条目声明托管端点（remotes），以便连接器目录将其列出；明确了 get_results 的排序说明（按时间顺序排列，last=N 会保留最新的 N 场）。
• 0.4.0 — 密钥为可选项：API 支持无密钥调用者，每个 IP 每天 300 次（每分钟 20 次），并会在 429 响应中说明如何获取免费密钥；更新了 about 和 list_leagues 的使用说明；新增 MCPB 桌面扩展包（manifest.json、图标）；注册表将 FC_API_KEY 标记为 isRequired: false。
• 0.3.0 — 为模型重写描述（何时使用 / 返回什么 / 示例）；新增方向指引工具 about_football_charts（无需密钥）；通过 view 将 get_rankings 并入 get_league_table；为 get_goal_timing 添加 team 筛选项和 peak_bins 说明；每次工具调用都会在标准错误输出一行结构化日志（工具、是否成功、毫秒数、密钥前缀——绝不包含参数）。
• 0.2.0 — 托管式 Streamable HTTP 传输、只读注解；注册表网关可通过标头、路径或查询参数接收密钥。

可以询问的问题

• “本周末过后，Allsvenskan 的冠军争夺形势如何？”
• “Flamengo 通常在什么时候进球——上半场还是下半场？”
• “显示 K League 积分榜，并告诉我哪些球队的表现超出了市场预期。”
• “Serie B 中哪支球队在比赛前 15 分钟内没有失球？”
• “Football Charts 本赛季的实际预测记录如何？”

配置

环境变量	默认值	用途
FC_API_KEY	—（必填）	你的 API 密钥
FC_API_BASE	FC production API	用于可自托管/测试场景的覆盖值

隐私政策

此扩展会通过 HTTPS 将你的工具请求（联赛密钥、球队名称、赛季—— 不会发送你的对话）发送至 football-charts.com 的 API。请求按 IP 限流；如果你配置了 API 密钥，该密钥会标识 你的账户，使用量按密钥统计。不会存储任何对话内容。Football Charts 的隐私政策： https://www.football-charts.com/privacy。如有疑问，请联系：[email protected]。

条款

可在注明出处（ “数据来自 football-charts.com”）的情况下免费用于个人和研究用途。不得转售数据。付费层级的商业用途： [email protected]。

许可证

MIT（仅限服务端代码）。football-charts.com API 提供的数据仍归 © football-charts.com 所有，并根据 https://www.football-charts.com/developers 中的条款提供。

Claude Code 插件

此仓库也是一个 Claude Code 插件（plugins/football-charts/）。它会添加 上述托管 MCP 服务（无需密钥）和 football-data 技能：

/plugin install football-charts --marketplace ddevetak/footballcharts-mcp

Cursor 插件

此仓库也是一个 Cursor 插件（.cursor-plugin/plugin.json）。它会添加 上述托管 MCP 服务（无需密钥）和 football-data 技能，用于介绍 这些工具和 REST API。若要在本地试用，请将仓库复制到 ~/.cursor/plugins/local/football-charts，重新加载 Cursor，然后在自定义设置中查看 Football Charts MCP 服务和技能。