Soccer MCP Server

基本能力

产品定位

Soccer MCP Server 是一个足球数据服务中间件，提供对 API-Football 服务的封装和扩展，使开发者能够更方便地获取和处理足球相关数据。

核心功能

• 联赛数据：包括联赛排名、赛程、时间表等
• 球队信息：球队基本信息和赛程
• 球员数据：球员统计数据和档案
• 比赛数据：实时比赛数据（事件、统计、时间线）和比赛分析

适用场景

• 足球数据分析应用
• 实时比赛跟踪系统
• 足球统计和预测平台
• 体育新闻和媒体网站

工具列表

联赛数据工具

• get_league_id_by_name：通过联赛名称获取联赛ID
• get_all_leagues_id：获取所有足球联赛ID列表
• get_standings：获取多个联赛和赛季的联赛排名
• get_league_info：获取特定足球联赛的信息
• get_league_fixtures：获取给定联赛和赛季的所有赛程
• get_league_schedule_by_date：获取联赛在指定日期的赛程

球员数据工具

• get_player_id：通过球员姓名获取球员ID和信息
• get_player_profile：通过姓氏获取球员档案
• get_player_statistics：按赛季和联赛名称获取详细球员统计数据
• get_player_statistics_2：按赛季和联赛ID获取详细球员统计数据

球队数据工具

• get_team_fixtures：返回球队过去或将来的赛程
• get_team_fixtures_by_date_range：获取球队在日期范围内的赛程
• get_team_info：获取特定球队的基本信息

比赛/赛程数据工具

• get_fixture_statistics：获取特定赛程的详细统计数据
• get_fixture_events：获取赛程中的所有比赛事件
• get_multiple_fixtures_stats：一次性获取多个赛程的统计数据

实时比赛数据工具

• get_live_match_for_team：检查球队是否正在比赛
• get_live_stats_for_team：获取球队在比赛中的实时统计数据
• get_live_match_timeline：获取球队实时比赛的事件时间线

常见问题解答

1. 如何获取API密钥？

2. 需要在 RapidAPI 上创建账户并订阅 API-Football API

3. 服务器运行需要什么环境？

4. Python 环境和 Docker（推荐）

5. 如何配置服务器？

6. 通过设置环境变量 RAPID_API_KEY_FOOTBALL 来配置API密钥

使用教程

使用依赖

1. 安装 Python 3.x
2. 安装 Docker（可选，推荐）

安装教程

选项1：使用Docker（推荐）

git clone https://github.com/obinopaul/soccer-mcp-server.git
cd soccer-mcp-server
pip install -r requirements.txt
docker build -t soccer_server .
docker run -d -p 5000:5000 -e RAPID_API_KEY_FOOTBALL=your_api_key_here --name soccer_server soccer_server

选项2：直接Python执行

git clone https://github.com/obinopaul/soccer-mcp-server.git
cd soccer-mcp-server
pip install -r requirements.txt
export RAPID_API_KEY_FOOTBALL=your_api_key_here
python soccer_server.py

调试方式

1. 检查服务器是否运行：

docker ps -a  # 对于Docker方式
ps aux | grep python  # 对于直接Python方式

1. 测试API端点：

curl http://localhost:5000/get_league_id_by_name?league_name="Premier League"

许可证

该项目遵循 MIT 开源许可条款。