soccer-mcp-server

🚀 足球 MCP 服务器

本足球 MCP 服务器基于 API-Football（现名为 Squawka）构建，借助模型定制平台（Model Customization Platform, MCP）提供接口。用户可通过此服务器获取实时和历史的足球数据，为足球数据的分析和应用提供有力支持。

🚀 快速开始

本服务器使用前需进行依赖安装、服务器启动以及环境变量的设置。具体步骤如下：

安装依赖

pip install fastapi python-multipart requests typing-extensions pydantic[dotenv]

启动服务器

uvicorn app:app --reload

环境变量

设置以下环境变量：

export API_KEY="your_api_key_here"

✨ 主要特性

数据类型

• 比赛数据：涵盖比分、进球时间、黄牌、红牌等详细信息。
• 球队信息：包含球队排名、积分、胜负记录等关键数据。
• 球员统计：提供射门次数、传球成功率、抢断数等球员表现数据。
• 联赛详情：展示各联赛的最新 standings 和赛程安排。

示例接口

# 获取比赛结果
match_data = client.get_match_by_id(349078)
print(match_data)

# 获取球队排名
standings = client.get_standings()
print(standings)

# 获取球员统计数据
player_stats = client.get_player_stats("messi")
print(player_stats)

💻 使用示例

基础用法

获取比赛详情

from fastapi import HTTPClient

client = HTTPClient()
response = client.get("http://localhost:8000/match/349078")
print(response.json())

获取联赛积分榜

curl http://localhost:8000/standings

🔧 技术细节

• 使用 FastAPI 框架构建，保证了服务器的高性能和可扩展性。
• 数据来源于 API-Football，确保数据的准确性和实时性。
• 通过 Pydantic 进行数据验证，提高了数据的可靠性。

📄 许可证

该服务器的源代码遵循 MIT 许可证。