足球 MCP 服务器

一个使用 API-Football 服务的，为足球统计和实时比赛数据实现模型上下文协议 (MCP) 的 Python 服务器。

概述

此服务器提供了一套全面的工具，用于通过 API-Football API 访问足球数据。它充当应用程序和足球数据服务之间的桥梁，提供全球联赛、球队和球员的实时比赛信息和历史统计数据。

特性

• 联赛数据（积分榜、赛程、时间表）
• 球队信息和赛程
• 球员统计数据和个人资料
• 实时比赛数据（事件、统计数据、时间线）
• 比赛分析（统计数据、事件）

配置

此服务器需要从 RapidAPI 获取 API-Football 服务的 API 密钥：

1. 在 RapidAPI 上创建一个帐户
2. 订阅 API-Football API
3. 设置环境变量：

   RAPID_API_KEY_FOOTBALL=your_api_key_here
   

工具

联赛数据

• get_league_id_by_name

  • 检索给定联赛名称的联赛 ID
  • 示例：get_league_id_by_name(league_name="Premier League")

• get_all_leagues_id

  • 检索包含 ID 的所有足球联赛的列表
  • 可以按国家/地区过滤
  • 示例：get_all_leagues_id(country=["England", "Spain"])

• get_standings

  • 检索多个联赛和赛季的联赛积分榜
  • 可以按球队过滤
  • 示例：get_standings(league_id=[39, 140], season=[2022, 2023])

• get_league_info

  • 检索有关特定足球联赛的信息
  • 示例：get_league_info(league_name="Champions League")

• get_league_fixtures

  • 检索给定联赛和赛季的所有赛程
  • 示例：get_league_fixtures(league_id=39, season=2023)

• get_league_schedule_by_date

  • 检索指定日期联赛的赛程
  • 示例：get_league_schedule_by_date(league_name="Premier League", date=["2024-03-08", "2024-03-09"], season="2023")

球员数据

• get_player_id

  • 检索与名称匹配的球员的球员 ID 和信息
  • 示例：get_player_id(player_name="Messi")

• get_player_profile

  • 按球员的姓氏检索球员的个人资料
  • 示例：get_player_profile(player_name="Messi")

• get_player_statistics

  • 按赛季和联赛名称检索详细的球员统计数据
  • 示例：get_player_statistics(player_id=154, seasons=[2022, 2023], league_name="La Liga")

• get_player_statistics_2

  • 按赛季和联赛 ID 检索详细的球员统计数据
  • 示例：get_player_statistics_2(player_id=154, seasons=[2022, 2023], league_id=140)

球队数据

• get_team_fixtures

  • 返回球队过去或即将到来的赛程
  • 示例：get_team_fixtures(team_name="Manchester United", type="past", limit=3)

• get_team_fixtures_by_date_range

  • 检索球队在日期范围内的赛程
  • 示例：get_team_fixtures_by_date_range(team_name="Liverpool", from_date="2023-09-01", to_date="2023-09-30", season="2023")

• get_team_info

  • 检索有关特定球队的基本信息
  • 示例：get_team_info(team_name="Real Madrid")

比赛/赛程数据

• get_fixture_statistics

  • 检索特定赛程的详细统计数据
  • 示例：get_fixture_statistics(fixture_id=867946)

• get_fixture_events

  • 检索赛程的所有游戏中事件（进球、牌、换人）
  • 示例：get_fixture_events(fixture_id=867946)

• get_multiple_fixtures_stats

  • 一次检索多个赛程的统计数据
  • 示例：get_multiple_fixtures_stats(fixture_ids=[867946, 867947, 867948])

实时比赛数据

• get_live_match_for_team

  • 检查球队当前是否正在进行直播比赛
  • 示例：get_live_match_for_team(team_name="Chelsea")

• get_live_stats_for_team

  • 检索比赛中球队的实时游戏统计数据
  • 示例：get_live_stats_for_team(team_name="Liverpool")

• get_live_match_timeline

  • 检索球队直播比赛的实时事件时间线
  • 示例：get_live_match_timeline(team_name="Manchester City")

用法

该服务器使用 Fast MCP 框架实现，可以作为独立服务运行。

# 启动服务器
python soccer_server.py
# 或
mcp run soccer-server.py

配置

• 服务器运行超时时间为 30 秒，以实现更可靠的运行
• 实现了信号处理程序以实现正常关闭 (Ctrl+C)

与 Claude Desktop 一起使用

选项 1：使用 Docker（推荐）

1. 克隆此存储库

git clone https://github.com/obinopaul/soccer-mcp-server.git
cd soccer-mcp-server

2. 安装依赖项

pip install -r requirements.txt

3. 构建 Docker 镜像

docker build -t soccer_server .

4. 运行 Docker 容器（确保您的 API 密钥作为环境变量传递）

docker run -d -p 5000:5000 -e RAPID_API_KEY_FOOTBALL=your_api_key_here --name soccer_server soccer_server

5. 将此添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "soccer_server": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "soccer_server",
        "python",
        "soccer_server.py"
      ],
      "env": {
        "RAPID_API_KEY_FOOTBALL": "your_api_key_here"
      }
    }
  }
}

选项 2：直接 Python 执行

1. 克隆此存储库

git clone https://github.com/obinopaul/soccer-mcp-server.git
cd soccer-mcp-server

2. 安装依赖项

pip install -r requirements.txt

3. 设置 API 密钥环境变量

export RAPID_API_KEY_FOOTBALL=your_api_key_here

4. 将此添加到您的 claude_desktop_config.json，根据需要调整 Python 路径：

{
  "mcpServers": {
    "soccer_server": {
      "command": "/path/to/your/python",
      "args": [
        "/path/to/soccer_server.py"
      ],
      "env": {
        "RAPID_API_KEY_FOOTBALL": "your_api_key_here"
      }
    }
  }
}

添加您选择的配置后，重新启动 Claude Desktop 以加载足球服务器。然后，您就可以在与 Claude 的对话中使用所有足球数据工具。

技术细节

该服务器构建于：

• 通过 RapidAPI 的 API-Football
• 用于 API 接口的 MCP
• 用于输入验证的 Pydantic
• 用于 API 通信的 Requests

许可证

此 MCP 服务器在 MIT 许可证下可用。