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