Footballbin Mcp Server

FootballBin MCP サーバー

プレミアリーグとチャンピオンズリーグの試合予測にAI エージェントがアクセスできるようにする、Model Context Protocol（MCP）サーバーです。

要件

• Node.js 18+（node --version で確認できます）

インストール

オプション 1：npm（推奨）

npm install -g footballbin-mcp-server

オプション 2：npx（インストール不要）

npx footballbin-mcp-server

オプション 3：リモートエンドポイント

インストールは不要です。ホストされているエンドポイントを直接使用します。

https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp

クイックスタート

Claude.ai（最も簡単・インストール不要）

1. 設定 > コネクタに移動します
2. カスタムコネクタを追加をクリックします
3. https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp を入力します

Claude Desktop

Node.js 18+ が必要です

ステップ 1： グローバルにインストールします

npm install -g footballbin-mcp-server

ステップ 2： Node.js のパスを確認します（v18 以上である必要があります）

which node && node --version

ステップ 3： claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "footballbin": {
      "command": "/path/to/node",
      "args": ["/path/to/node_modules/footballbin-mcp-server/dist/index.js"]
    }
  }
}

設定例：

nvm を使用する macOS：

{
  "mcpServers": {
    "footballbin": {
      "command": "/Users/YOU/.nvm/versions/node/v20.x.x/bin/node",
      "args": ["/Users/YOU/.nvm/versions/node/v20.x.x/lib/node_modules/footballbin-mcp-server/dist/index.js"]
    }
  }
}

Homebrew を使用する macOS：

{
  "mcpServers": {
    "footballbin": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/footballbin-mcp-server/dist/index.js"]
    }
  }
}

Windows：

{
  "mcpServers": {
    "footballbin": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\YOU\\AppData\\Roaming\\npm\\node_modules\\footballbin-mcp-server\\dist\\index.js"]
    }
  }
}

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

その他の MCP クライアント

リモートエンドポイントを使用します：

https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp

機能

• AI による試合予測：

  • ハーフタイムのスコア
  • 試合終了時のスコア
  • 次のゴールを決める選手
  • コーナーキック数の予測

• 対応リーグ：

  • プレミアリーグ（EPL）
  • UEFA チャンピオンズリーグ（UCL）

• キープレーヤー：各試合には、根拠を含むキープレーヤーの分析が含まれます

ツール：get_match_predictions

入力パラメーター

パラメーター	型	必須	説明
league	string	はい	premier_league、epl、pl、champions_league、ucl、cl
matchweek	number	いいえ	節番号（省略時は現在の節）
home_team	string	いいえ	ホームチームで絞り込み（例：chelsea、arsenal）
away_team	string	いいえ	アウェイチームで絞り込み（例：liverpool、wolves）

チームの別名

別名	対応先
united、mufc	man_utd
city、mcfc	man_city
spurs	tottenham
villa	aston_villa
forest	nottm_forest
palace	crystal_palace
gunners	arsenal
reds	liverpool
blues	chelsea
barca	barcelona
real	real_madrid

応答例

{
  "league": "premier_league",
  "matchweek": 22,
  "count": 10,
  "app_link": "https://apps.apple.com/app/footballbin/id6757111871",
  "matches": [
    {
      "match_id": "epl_mw22_liv_bur",
      "home_team": "Liverpool",
      "away_team": "Burnley",
      "kickoff_time": "2026-01-17T15:00:00Z",
      "status": "scheduled",
      "predictions": [
        { "type": "Half Time Result", "value": "2:0", "confidence": 75 },
        { "type": "Full Time Result", "value": "4:0", "confidence": 75 },
        { "type": "Next Goal", "value": "Home,Wirtz", "confidence": 75 },
        { "type": "Corner Count", "value": "9:3", "confidence": 75 }
      ],
      "key_players": [
        {
          "player_name": "Florian Wirtz",
          "reason": "12 goals, 14 assists. Liverpool's creative hub."
        }
      ]
    }
  ]
}

API を直接使用する

ツール一覧

curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

予測を取得する

curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_match_predictions",
      "arguments": {"league": "premier_league"}
    },
    "id": 1
  }'

レジストリのリンク

• npm：https://www.npmjs.com/package/footballbin-mcp-server
• 公式 MCP レジストリ：https://registry.modelcontextprotocol.io
• GitHub：https://github.com/billychl1/footballbin-mcp-server

FootballBin アプリ

FootballBin iOS アプリで、すべての機能をご利用いただけます：

機能：

• 試合のライブ追跡
• AI による選手の評価額
• 詳細な試合予測
• 選手のニュースとディスカッション

技術的な詳細

• プロトコル：JSON-RPC 2.0 / MCP
• トランスポート：stdio（npm）または HTTPS（リモート）
• ランタイム：Node.js 20+

エラーコード

コード	意味
-32700	解析エラー
-32600	無効なリクエスト
-32601	メソッドが見つかりません
-32602	無効なパラメーター

ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください。

リンク

• FootballBin アプリ
• Model Context Protocol