JinDaGe - footballbin-mcp-server MCP Details

article

README

🚀 FootballBin MCP 服务器

FootballBin MCP 服务器是一个基于模型上下文协议（MCP）的服务器，它为 AI 智能体提供英超联赛和欧冠联赛的足球比赛预测服务。

🚀 快速开始

Claude.ai（最简单 - 无需安装）

前往 设置 > 连接器。
点击 添加自定义连接器。
输入：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、epl、pl、champions_league、ucl、cl | | matchweek | 数字 | 否 | 比赛周数（默认为当前周） | | home_team | 字符串 | 否 | 按主队过滤（例如 chelsea、arsenal） | | away_team | 字符串 | 否 | 按客队过滤（例如 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

🔧 技术细节

协议：JSON-RPC 2.0 / MCP
传输方式：stdio（npm）或 HTTPS（远程）
运行时：Node.js 20+

错误代码

| 代码 | 含义 | |------|------| | -32700 | 解析错误 | | -32600 | 无效请求 | | -32601 | 方法未找到 | | -32602 | 无效参数 |

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🔗 链接

📱 FootballBin 应用

通过 FootballBin iOS 应用获得完整体验：

应用特性：

实时比赛跟踪
AI 球员估值
详细比赛预测
球员新闻和讨论

footballbin-mcp-server