Soccer MCP Server

🚀 サッカー MCP サーバー

このサッカー MCP サーバーは、API-Football（現在は Squawka）をベースに構築されており、モデルカスタマイズプラットフォーム（Model Customization Platform, MCP）を通じてインターフェースを提供します。ユーザーはこのサーバーを通じて、リアルタイムおよび過去のサッカーデータを取得することができます。

🚀 クイックスタート

このサッカー MCP サーバーを利用することで、ユーザーはリアルタイムおよび過去のサッカーデータを取得することができます。以下に、基本的な使い方を紹介します。

✨ 主な機能

データタイプ

• 試合データ：スコア、ゴール時間、イエローカード、レッドカードなどが含まれます。
• チーム情報：チームの順位、得点、勝敗記録などが含まれます。
• 選手統計：シュート数、パス成功率、タックル数などが含まれます。
• リーグ詳細：各リーグの最新の順位表と試合日程が含まれます。

サンプルインターフェース

# 試合結果を取得
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 ライセンスに従います。