Openfoot Mcp

io.github.bartokulus由 GitHub 账号 bartokulus 发布v0.1.2更新于 Oct 24, 2026

Football fixtures, standings, lineups, live events and shot-level xG across 75 competitions.

已验证STDIO仅桌面金融数据与分析

概览

AI 生成的概览

本地 MCP 服务器，通过 OpenFootAPI 为助手提供真实足球数据：赛程、积分榜、阵容、实时事件、逐射门 xG 和公平赔率。

可以做什么
查询赛事、赛季和数据来源，并用自由文本搜索把球队或赛事名称解析为稳定 ID。按日期、赛事、球队、状态、赛季或轮次筛选获取赛程与赛果，以及积分榜。读取比赛详情：首发阵容与阵型、进球、红黄牌、换人和文字直播时间线。获取带球场坐标的逐射门 xG、联赛 xG 表，以及状态、交锋等衍生背景信息。查看博彩公司基准与隐含公平概率、当月剩余配额和 API 可达性。
适用场景
适合让助手基于真实数据回答足球问题，而不是编造比分，尤其是覆盖最深的联赛（德甲、德乙、德国杯、罗马尼亚超级联赛）和扩展的欧洲赛事。也适合借助内置球探提示做基于 xG 的球队状态分析。
运行要求
通过 npx 以 stdio 在本地运行，需要 Node.js 20 或更高版本。需要 OpenFootAPI 密钥，通过环境变量 OPENFOOT_API_KEY 提供；有每月 5,000 次请求的免费额度。需要能访问 OpenFootAPI 服务的网络。
安装前请注意
API 密钥是敏感信息，通过环境变量传入。每次请求都计费，包括 404 和空结果，因此猜测 ID 会浪费配额；服务器会把配额或限流问题报为错误而非空结果。存在付费套餐，配额按月重置。赔率数据仅供参考，不构成投注建议。各赛事覆盖深度不一，依赖前请先确认该联赛。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Openfoot Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

openfoot-mcp

MCP server for the OpenFootAPI football intelligence API. Gives an LLM client real football data — fixtures, standings, lineups, live events, shot-level xG with pitch coordinates, and model-derived fair odds — instead of a hallucinated scoreline.

15 tools, 1 prompt. Node ≥ 20, no build step.

Install

bash
npx openfoot-mcp

Set your API key in the environment. Free tier: 5,000 requests/month. Get a key at openfootapi.com/pricing.

Claude Desktop / Claude Code

json
{  "mcpServers": {    "openfoot": {      "command": "npx",      "args": ["-y", "openfoot-mcp"],      "env": { "OPENFOOT_API_KEY": "of_live_..." }    }  }}

Cursor / Windsurf / any stdio MCP client

Same block, in that client's MCP config file.

Tools

ToolWhat it returns
openfoot_competitionsSupported competitions, season metadata, data source and licence per competition
openfoot_searchFree-text team/competition name → stable IDs
openfoot_matchesFixtures and results, filtered by date / competition / team / status / season / round, cursor-paginated
openfoot_standingsStandings table for a competition and season
openfoot_match_lineupsStarting XI, bench, formation
openfoot_match_eventsGoals, cards, substitutions, commentary timeline
openfoot_match_xgOne entry per shot: pitch coordinates + xG value
openfoot_match_contextDerived context — form, head-to-head, pre-computed signals
openfoot_league_xgLeague xG table: xG for, xG against, over/under-performance vs actual goals
openfoot_oddsBookmaker benchmark + implied fair probabilities. Informational, not betting advice
openfoot_quotaRemaining monthly quota — this call does not consume quota
openfoot_healthReachability check. Works without an API key

Prompt: scout_team_form — resolve a team, pull its last 5 matches, read the xG behind the results.

Start with openfoot_search to resolve IDs. Guessing IDs wastes quota: 404s and empty results are metered like any other request.

Coverage, stated honestly

The catalogue lists 120 competitions. Depth is not uniform, and the catalogue is wider than the deep coverage.

  • Deepest: Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României
  • Expanded European: Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership
  • Historical / analytics only: Premier League, La Liga, Serie A, Ligue 1 (xG is Understat-derived)

Call openfoot_competitions and check your league before you build on it.

Quota behaviour

  • Free: 5,000 requests/month, 60 req/min. Developer $14/month: 250,000 requests/month, 100 req/min, includes xG, shot maps, lineups, live events and fair odds. Pro $39/month: 2,000,000/month, 250 req/min.
  • No overage billing. When the quota is spent the API returns 429; this server surfaces that as a quota_or_rate_limit error rather than an empty result.
  • Quota resets on the 1st of the month, UTC.
  • Every request is metered, including 404s and empty results.

When this is the wrong tool

  • High-frequency live polling across many competitions. A monthly quota is the wrong shape for it — a per-day or per-second plan elsewhere will cost you less.
  • Leagues outside the deep-coverage list above.
  • You need a contractual SLA, uptime credits or a named support contact. Not offered at these prices.

Development

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

npm run smoke works without an API key: openfoot_health returns live status, and a key-gated tool returns a readable missing_api_key error so you can tell "not configured" from "broken".

MIT.

来源：README.md，提交 2b70ef1

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分