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 許可證。