Soccer MCP Server

足球 MCP 服务

使用 API-Football 服务实现 Model Context Protocol (MCP) 的 Python 服务，可提供足球（英式足球）统计数据和实时比赛数据。

概览

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

功能

• 联赛数据（排名、赛程、比赛安排）
• 球队信息和赛程
• 球员统计数据和资料
• 实时比赛数据（事件、统计数据、时间线）
• 比赛分析（统计数据、事件）

配置

此服务需要用于 API-Football 服务的 RapidAPI 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 框架实现，可以作为独立服务运行。

# Start the server
python soccer_server.py
# or
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
• 使用 MCP 作为 API 接口
• 使用 Pydantic 进行输入验证
• 使用 Requests 进行 API 通信

许可证

此 MCP 服务采用 MIT 许可证。