AI Ball — AI football match analysis

AI Ball MCP 服务

面向 AI Ball 的只读 Model Context Protocol 服务，用于 AI 足球比赛分析。

它为 AI 助手提供两类信息：

• 赛前结果概率。 对于每场比赛，提供模型在开球前记录的主胜、平局和客胜概率。
• 公开记录。 比赛之后发生了什么：最终比分，以及模型最可能的结果是否命中。未命中与命中一视同仁，事后也不会移除任何记录。

无需账户或 API 密钥。该服务只会调用 AI Ball 的公开记录 API。

工具

工具	返回内容
list_matches	某一日的比赛：match_id、开球时间、联赛、球队和状态（upcoming、pending 或 finished）
get_match_analysis	单场比赛：开球前记录的主胜、平局和客胜概率、最可能的结果、置信度、记录时间；比赛结束后，还会提供比分以及预测是否命中
get_open_record	完整记录，或通过 week_start 指定的一周记录：纳入统计的比赛数、模型预测正确的场数、同一批比赛的两个基准，以及各置信度区间的场次

所有工具均为只读（readOnlyHint: true）。工具名称提供英文（lang: "en"）和马来文（lang: "ms"）版本。响应由固定字段列表构建，不会原样传递上游 API 的任何内容。

如何解读数据

• models.balanced 包含 home、draw 和 away 的概率值，总和为 1。此版本返回平衡模型；models_available 列出所包含的模型。
• 当模型最可能的结果实际发生时，result.hit 为 true。
• hit_rate 是百分比。null 表示样本量低于 min_band_sample，此时请改用计数 hits 和 n。
• favourite_baseline 通过始终选择赛前热门来评估同一批比赛；random_baseline 则为三种结果各占三分之一。
• upcoming 比赛的赛前数据会在开球前锁定。pending 比赛包含当前预测，之后仍可能变化。

该服务会将每个上游响应缓存五分钟，并控制请求间隔，因此重复查询不会再次调用 AI Ball 的 API。

托管版本

不想安装任何内容？相同的记录也通过 MCP 提供：

https://aiball.samagent.ai/mcp

使用 Streamable HTTP，无需登录，且为只读。除下方三个工具外，还提供 get_match_context（仅限已结束比赛的交锋记录、近期状态、伤病和赛程）。速率限制：每个 IP 每分钟 60 个请求。

claude mcp add --transport http aiball https://aiball.samagent.ai/mcp

安装（本地版本）

Claude Desktop

从最新版本下载 aiball-mcp.mcpb 并打开。

Claude Code

claude mcp add aiball -- npx -y github:aiballfooty/aiball-mcp

Cursor、VS Code 和其他客户端

{
  "mcpServers": {
    "aiball": {
      "command": "npx",
      "args": ["-y", "github:aiballfooty/aiball-mcp"]
    }
  }
}

需要 Node.js 18 或更高版本。

示例问题

• “AI Ball 的模型对上周的比赛预测得怎么样？”
• “上周哪些比赛是模型预测错的？”
• “按马来西亚时间，模型对今天比赛的概率预测是什么？”
• “从完整记录来看，模型是否比始终选择热门预测得更准？”

隐私

该服务在你的计算机上运行，只会向 https://aiball.samagent.ai/api/v1 发送请求。请求包含工具参数（日期、时区、语言）以及 User-Agent aiball-mcp/<version>。请求不会包含你的对话、文件或任何标识符。AI Ball 的 Web 服务器会保留标准访问日志。网站隐私政策：https://aiball.samagent.ai/en/privacy

开发

npm install
npm test        # starts the server and calls every tool against the live API

设置 AIBALL_API_BASE，将服务指向其他基础 URL。

许可证

MIT。仅供参考，不构成建议。年满 18 岁方可使用。