Footballbin MCP Server

🚀 FootballBin MCP 服務器

FootballBin MCP 服務器是一個基於模型上下文協議（MCP）的服務器，它為 AI 智能體提供英超聯賽和歐冠聯賽的足球比賽預測服務。

🚀 快速開始

Claude.ai（最簡單 - 無需安裝）

1. 前往 設置 > 連接器。
2. 點擊 添加自定義連接器。
3. 輸入：https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp

Claude 桌面版

需要 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"]
    }
  }
}

示例配置：

macOS 搭配 nvm：

{
  "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"]
    }
  }
}

macOS 搭配 Homebrew：

{
  "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）
  • 歐洲冠軍聯賽（UCL）

• 關鍵球員：每場比賽都包含關鍵球員的洞察及推理依據。

📦 安裝指南

選項 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

💻 使用示例

工具：get_match_predictions

輸入參數

球隊別名

示例響應

{
  "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

🔧 技術細節

• 協議：JSON-RPC 2.0 / MCP
• 傳輸方式：stdio（npm）或 HTTPS（遠程）
• 運行時：Node.js 20+

錯誤代碼

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

🔗 鏈接

• FootballBin 應用
• 模型上下文協議

📱 FootballBin 應用

通過 FootballBin iOS 應用獲得完整體驗：

應用特性：

• 即時比賽跟蹤
• AI 球員估值
• 詳細比賽預測
• 球員新聞和討論