Footballbin Mcp Server

io.github.billychl1由 GitHub 帳號 billychl1 發布v1.0.4更新於 Oct 24, 2026

AI match predictions for Premier League & Champions League - scores, goals, corners

已驗證STDIO僅桌面位置與生活

概覽

AI 產生的概覽

讓助理取得英超與歐冠賽事的 AI 預測,包括半場與全場比分、下一個進球球員和角球數。

可以做什麼
  • 依聯賽與輪次查詢賽事預測,可依主隊或客隊篩選
  • 取得每場比賽的半場比分、全場比分、下一個進球球員與角球數預測
  • 查看每場比賽的關鍵球員與其理由
  • 篩選時支援 spurs、united 等球隊別名
適用情境
當你想讓助理查詢或討論即將開打的英超、歐冠賽事預測、賽前預覽或逐場分析,而不想開啟配套 App 時使用。
執行需求
可使用託管的 HTTPS 端點(免安裝),或在本地以 Node.js 18+ 執行 npm 套件 footballbin-mcp-server(README 另處寫 Node.js 20+)。未宣告需要帳號、API 金鑰或環境變數。
安裝前請注意
預測為第三方估算,不保證結果,應視為觀點而非投注建議。請求會送往提供者的託管服務,回傳內容包含其 iOS App 連結。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Footballbin Mcp Server,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

FootballBin MCP Server

[npm version] [MCP Registry] [License: MIT]

A Model Context Protocol (MCP) server that provides AI agents with access to football match predictions for the Premier League and Champions League.

Requirements

  • Node.js 18+ (check with node --version)

Installation

Option 1: npm (Recommended)

bash
npm install -g footballbin-mcp-server

Option 2: npx (No Install)

bash
npx footballbin-mcp-server

Option 3: Remote Endpoint

No installation required - use the hosted endpoint directly:

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

Quick Start

Claude.ai (Easiest - No Install)

  1. Go to Settings > Connectors
  2. Click Add custom connector
  3. Enter: https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp

Claude Desktop

Requires Node.js 18+

Step 1: Install globally

bash
npm install -g footballbin-mcp-server

Step 2: Find your Node.js path (must be v18+)

bash
which node && node --version

Step 3: Add to claude_desktop_config.json:

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

Example configs:

macOS with nvm:

json
{  "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 with Homebrew:

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

Windows:

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

Config file location:

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

Other MCP Clients

Use the remote endpoint:

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

Features

  • AI Match Predictions:

    • Half-time score
    • Full-time score
    • Next goal scorer
    • Corner count predictions
  • Supported Leagues:

    • Premier League (EPL)
    • UEFA Champions League (UCL)
  • Key Players: Each match includes key player insights with reasoning

Tool: get_match_predictions

Input Parameters

ParameterTypeRequiredDescription
leaguestringYespremier_league, epl, pl, champions_league, ucl, cl
matchweeknumberNoMatchweek number (defaults to current)
home_teamstringNoFilter by home team (e.g., chelsea, arsenal)
away_teamstringNoFilter by away team (e.g., liverpool, wolves)

Team Aliases

AliasMaps To
united, mufcman_utd
city, mcfcman_city
spurstottenham
villaaston_villa
forestnottm_forest
palacecrystal_palace
gunnersarsenal
redsliverpool
blueschelsea
barcabarcelona
realreal_madrid

Example Response

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

Direct API Usage

List Tools

bash
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}'

Get Predictions

bash
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  }'

Registry Links

FootballBin App

Get the full experience with the FootballBin iOS app:

[Download on App Store]

Features:

  • Live match tracking
  • AI player valuations
  • Detailed match predictions
  • Player news and discussions

Technical Details

  • Protocol: JSON-RPC 2.0 / MCP
  • Transport: stdio (npm) or HTTPS (remote)
  • Runtime: Node.js 20+

Error Codes

CodeMeaning
-32700Parse error
-32600Invalid request
-32601Method not found
-32602Invalid params

License

MIT License - see LICENSE file.

Links

來源:README.md,提交 447de98

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分