足球MCP服务器
一个Python服务器，使用API-football服务实现用于足球统计和现场比赛数据的模型上下文协议（MCP）。
概述
该服务器提供了一套全面的工具，用于通过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_fix
- 返回球队过去或即将到来的赛程 - 例子： 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_统计
- 检索特定夹具的详细统计信息 - 例子： get_fixture_statistics(fixture_id=867946)
- get_fixture_events
- 检索一个固定装置的所有游戏内事件（目标、卡牌、潜艇） - 例子： get_fixture_events(fixture_id=867946)
- get_multiplefixtures_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（推荐）
- 克隆此存储库
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"
}
}
}
}添加所选配置后，重新启动Claude Desktop以加载足球服务器。然后，您将能够在与克劳德的对话中使用所有足球数据工具。
技术细节
服务器构建于：
- API-通过RapidAPI的足球
- API接口MCP
- Pydantic用于输入验证
- API通信请求
许可证
此MCP服务器在MIT许可证下可用。