football-api-mcp

5DollarFootballAPI 用の MCP (Model Context Protocol) サーバー — Claude、Cursor、および MCP 対応の AI アシスタントにライブのフットボール（サッカー）データを提供します: 試合日程、ライブスコア、順位表、統計、ベッティングオッズ、そしてオッズ変動の全履歴（コーナーキック数やカード数のラインを含む）。

アシスタントに次のような質問ができます:

• "今日のプレミアリーグの試合と現在のスコアは？"

• "今シーズンのリーグ 39 のコーナーキック順位を見せて。"

• "試合 1234567 の 1x2 オッズはキックオフ前にどう動いた？"

セットアップ

5dollarfootballapi.com の API キーが必要です — 無料プラン（カード不要）では試合日程、ライブスコア、順位表を利用できます。オッズツールは有料プラン（月額 $5 から）が必要です。

Claude Code

claude mcp add football-api -e FIVEDOLLARFOOTBALL_API_KEY=fb_live_your_key -- npx -y football-api-mcp

Claude Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に追加:

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

ツール

すべてのツールは読み取り専用です。エラーは API のエラーコードとリクエスト ID を含むツールエラーとして返されるため、アシスタントが何が問題だったかを説明できます。

開発

npm install
npm test          # in-memory MCP client/server tests, no network
FIVEDOLLARFOOTBALL_API_KEY=... npm start   # run over stdio

基盤となる HTTP クライアントは公式の fivedollarfootball パッケージです。エンドポイントのリファレンス: 5dollarfootballapi.com/docs。

ライセンス

MIT