足球 MCP 服务器

概述

这个足球 MCP 服务器基于 API-Football（现为 Squawka）构建，通过模型定制平台（Model Customization Platform, MCP）提供接口。它允许用户获取实时和历史的足球数据。

功能

数据类型

• 比赛数据：包括比分、进球时间、黄牌、红牌等。
• 球队信息：球队排名、积分、胜负记录等。
• 球员统计：射门次数、传球成功率、抢断数等。
• 联赛详情：各联赛的最新 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)

配置

安装依赖

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

启动服务器

uvicorn app:app --reload

环境变量

设置以下环境变量：

export API_KEY="your_api_key_here"

使用示例

获取比赛详情

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 许可证。