AI Ball — AI football match analysis

AI Ball MCP サーバー

AI Ball（AI によるサッカー試合分析）向けの読み取り専用Model Context Protocolサーバーです。

AI アシスタントに次の 2 つの情報を提供します。

• キックオフ前の結果確率。 各試合について、モデルが記録したホーム勝利／引き分け／アウェイ勝利の確率です。
• 公開記録。 試合後に何が起きたかを確認できます。最終スコアと、モデルが最も可能性が高いと予測した結果が実現したかどうかがわかります。予測が外れた試合も当たった試合と同様に数えられ、後から記録が削除されることはありません。

アカウントも API キーも不要です。このサーバーが呼び出すのは、AI Ball の公開記録 API のみです。

ツール

ツール	返される情報
list_matches	暦日 1 日分の試合：match_id、キックオフ時刻、リーグ、チーム、ステータス（upcoming、pending、finished のいずれか）
get_match_analysis	1 試合分の情報：キックオフ前に記録されたホーム勝利／引き分け／アウェイ勝利の確率、最も可能性が高い結果、確信度、予測が記録された日時、試合後はスコアと予測が的中したかどうか
get_open_record	全記録、または week_start で指定した 1 週間分の記録：集計対象の試合数、モデルの予測が的中した数、同じ試合に対する 2 つのベースライン、確信度帯ごとの件数

すべてのツールは読み取り専用です（readOnlyHint: true）。名称は英語（lang: "en"）とマレー語（lang: "ms"）で利用できます。応答は固定のフィールド一覧から構成され、上流 API の内容がそのまま渡されることはありません。

数値の見方

• models.balanced には、合計が 1 になる home、draw、away の確率が含まれます。このバージョンが返すのはバランス型モデルです。models_available に含まれるモデルが一覧表示されます。
• result.hit は、モデルが最も可能性が高いと予測した結果が実現した場合に true になります。
• hit_rate はパーセンテージです。サンプル数が min_band_sample 未満の場合は null になるため、代わりに hits と n の件数を使用してください。
• favourite_baseline は、試合前に優勢と見なされたチームを常に選んだ場合の結果を、同じ試合で評価します。random_baseline は 3 つの結果のうち 1 つを選ぶ場合の基準です。
• upcoming の試合はキックオフ前にロックされます。pending の試合には現在の予測が含まれますが、まだ変更される可能性があります。

サーバーは各上流レスポンスを 5 分間キャッシュし、リクエストの間隔を空けるため、同じ質問を繰り返しても AI Ball の API に再度アクセスしません。

ホステッド版

インストールせずに使いたい場合は、同じ記録を MCP 経由で次の場所から利用できます。

https://aiball.samagent.ai/mcp

Streamable HTTP、サインイン不要、読み取り専用です。以下の 3 つのツールに加えて、get_match_context（終了した試合のみ、直接対決、最近の成績、負傷者、試合日程）を利用できます。レート制限：IP ごとに 1 分あたり 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 のウェブサーバーでは標準的なアクセスログが記録されます。サイトのプライバシーポリシー：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 歳以上。