howillmakeit/football-mcp - 足球数据 MCP 服务器

前言¶

在开发基于 Claude、Cursor 或 DeepSeek Harness 的智能体时，接入体育数据往往意味着编写爬虫或解析 HTML。这个插件通过 MCP (Model Context Protocol) 标准接口，直接为这些智能体提供足球数据服务。它无需 API Key，覆盖了 18 个欧洲联赛和 8 个杯赛的历史与实时数据。

定位¶

howillmakeit/football-mcp 是一个面向 DeepSeek Harness、Claude、Codex 和 Cursor 的足球数据 MCP 服务器。它解决了智能体需要获取结构化足球数据（比分、积分榜、赔率、交锋记录等）时的接口对接问题。

核心功能¶

该插件提供以下工具接口：

• list_competitions()
  查看支持的所有联赛及其代码。
• list_teams(competition, season)
  查询某联赛某赛季的所有球队代码。这是进行球队过滤前的必要步骤。
• get_matches(...)
  查询比赛结果或赛程。支持按球队、日期、已赛/未赛过滤，并可获取射门、角球、红黄牌以及约 20 家博彩公司的 1X2 开盘与收盘赔率。
• get_standings(competition, season, as_of_date?)
  查询联赛积分榜。通过 as_of_date 参数，可以回看过去某一天的积分榜排名。
• get_team_form(team, ...)
  查询某队最近 N 场比赛的战绩、胜平负、进失球及场均积分。
• get_head_to_head(a, b, ...)
  查询两队历史交锋记录，包括胜负平与进球数，支持按联赛、杯赛或具体赛事分组。
• list_cup_competitions()
  查看支持的杯赛列表。
• get_cup_matches(...)
  查询杯赛对阵情况，包含点球决胜的处理逻辑。

安装与启用¶

在 DeepSeek Harness 环境中，通过命令行安装：

dsh plugin --profile web add football-data-mcp

安装后，工具将作为 mcp__football__* 格式的接口在 DSH 会话中可用。

前置要求：
* Node.js ≥ 18
* uv（Python 服务器依赖，需在 PATH 环境变量中）

典型用法¶

查询过去 10 个赛季巴塞罗那与皇家马德里的国家德比胜率（含联赛和杯赛）：

get_head_to_head("Barcelona", "Real Madrid", "SP1", "2025-26", seasons_back=9, scope="all")

系统将返回 25 次交锋的详细统计：巴萨 12 胜（48%）、皇马 9 胜（36%）、4 平。数据会按联赛和杯赛分别列出。

注意事项¶

• 点球决胜：在交锋统计中，点球决胜直接计为点球获胜方的胜利（通过 pen_wins_a/b 字段披露）。
• 进球统计：仅统计常规时间和加时赛进球。
• 积分榜：不包含行政扣分（源数据中未提供此类信息）。
• 本地依赖：插件运行需要 Python 环境，且通过 uv 启动。

总结¶

howillmakeit/football-mcp 是一个轻量级的数据提供者，专注于欧洲主流足球赛事。它通过标准的 MCP 接口，将 football-data.co.uk 和 ESPN 的数据转化为智能体可直接调用的工具。对于需要构建体育分析 Agent 的开发者，这是一个无需额外配置 API Key 的可用方案。

• 项目地址：GitHub
• 插件目录：SkillHub Catalog