MCP 服务器

Soccer MCP Server

通过 API-Football 提供对全面足球统计数据和实时比赛数据的程序化访问，使应用程序能够检索联赛排名、球队赛程、球员统计数据和实时比赛事件。

README

足球 MCP 服务器

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

概述

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

特性

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

配置

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

在 RapidAPI 上创建一个帐户
订阅 API-Football API

设置环境变量：

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（推荐）

克隆此存储库

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

安装依赖项

pip install -r requirements.txt

构建 Docker 镜像

docker build -t soccer_server .

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

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

将此添加到您的 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 执行

克隆此存储库

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

安装依赖项

pip install -r requirements.txt

设置 API 密钥环境变量

export RAPID_API_KEY_FOOTBALL=your_api_key_here

将此添加到您的 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"
      }
    }
  }
}