Soccer MCP Server

基本能力

产品定位

Soccer MCP Server 是一个足球数据服务中间件，专门为需要访问足球统计和实时比赛数据的应用程序提供支持。

核心功能

• 联赛数据：包括积分榜、赛程、赛程表等
• 球队信息：球队信息和赛程
• 球员数据：球员统计和资料
• 实时比赛数据：比赛事件、统计、时间线
• 比赛分析：统计数据和事件

适用场景

• 足球数据分析应用
• 实时比赛跟踪系统
• 球队和球员统计研究
• 足球相关游戏和模拟

工具列表

1. League Data
2. get_league_id_by_name: 根据联赛名称获取联赛ID
3. get_all_leagues_id: 获取所有足球联赛ID列表
4. get_standings: 获取多个联赛和赛季的积分榜
5. get_league_info: 获取特定足球联赛的信息
6. get_league_fixtures: 获取给定联赛和赛季的所有赛程

7. get_league_schedule_by_date: 获取指定日期的联赛赛程

8. Player Data

9. get_player_id: 根据名称获取球员ID和信息
10. get_player_profile: 根据姓氏获取球员资料
11. get_player_statistics: 按赛季和联赛名称获取详细球员统计

12. get_player_statistics_2: 按赛季和联赛ID获取详细球员统计

13. Team Data

14. get_team_fixtures: 返回球队过去或即将到来的赛程
15. get_team_fixtures_by_date_range: 获取球队在日期范围内的赛程

16. get_team_info: 获取特定球队的基本信息

17. Match/Fixture Data

18. get_fixture_statistics: 获取特定赛程的详细统计
19. get_fixture_events: 获取赛程的所有比赛事件

20. get_multiple_fixtures_stats: 一次性获取多个赛程的统计

21. Live Match Data

22. get_live_match_for_team: 检查球队是否正在直播比赛
23. get_live_stats_for_team: 获取球队在比赛中的实时统计
24. get_live_match_timeline: 获取球队实时比赛事件的时间线

常见问题解答

1. 如何获取API密钥？

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

3. 如何设置环境变量？

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

5. 服务器运行超时时间是多少？

6. 服务器运行有30秒的超时设置

使用教程

使用依赖

1. 需要Python环境
2. 需要RapidAPI账户和API-Football API订阅

安装教程

Option 1: Using Docker (Recommended)

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

Option 2: Direct Python Execution

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容器是否正常运行

docker ps

1. 检查服务器日志

docker logs soccer_server

1. 测试API端点

curl http://localhost:5000/health

许可证

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