Obinopaul Soccer MCP Server

🚀 サッカー MCP サーバー

API-Football サービスを使用して、モデルコンテキストプロトコル（MCP）を実装したサッカーデータ分析サーバーです。このサーバーは、包括的なサッカーデータを提供し、Claude Desktop との統合もサポートしています。

🚀 クイックスタート

このサッカー MCP サーバーは API-Football をベースに構築されており、MCP プロトコルを通じてユーザーに豊富なサッカー関連のデータと機能を提供します。ユーザーは設定を通じてこのサーバーを Claude Desktop に統合し、リアルタイムまたは過去のサッカー試合データ、チーム情報、その他の関連統計を取得することができます。

✨ 主な機能

コア機能

• リアルタイムデータ：現在進行中のサッカー試合のリアルタイムデータを取得します。
• 過去のデータ：過去の試合結果と詳細な統計データを照会します。
• チーム情報：特定のチームの基本情報、選手陣、過去の成績を取得します。
• リーグ順位：各サッカーリーグの最新の順位表を確認します。
• 試合カレンダー：将来開催されるサッカー試合の日程を取得します。

高度な機能

• データ分析：試合データを統計分析し、視覚化されたレポートを生成します。
• スコア予測：過去のデータに基づいて簡単なスコア予測モデルを提供します。
• ニュース更新：特定のチームまたはリーグに関連する最新のニュース動向を取得します。

📦 インストール

依存関係のインストール

pip install -r requirements.txt

サーバーの起動

python soccer_server.py

設定例

Docker での実行

1. リポジトリをクローンします：

   git clone https://github.com/obinopaul/soccer-mcp-server.git
   cd soccer-mcp-server
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

3. Docker イメージを構築します：

   docker build -t soccer_server .
   

4. コンテナを起動し、環境変数を設定します：

   docker run -d -p 5000:5000 -e RAPID_API_KEY_FOOTBALL=your_api_key_here --name soccer_server soccer_server
   

Python スクリプトを直接実行する

1. 環境変数を設定します：

   export RAPID_API_KEY_FOOTBALL=your_api_key_here
   

2. claude_desktop_config.json に設定を追加します：

   {
     "mcpServers": {
       "soccer_server": {
         "command": "/path/to/your/python",
         "args": [
           "/path/to/soccer_server.py"
         ],
         "env": {
           "RAPID_API_KEY_FOOTBALL": "your_api_key_here"
         }
       }
     }
   }
   

🔧 技術詳細

使用されている技術

• API-Football：RapidAPI を通じてサッカーデータを提供します。
• MCP プロトコル：統一された API インターフェースを実装します。
• Pydantic：入力検証とデータモデリングに使用されます。
• Requests：HTTP リクエストを処理します。

📄 ライセンス

この MCP サーバーは MIT License の下でオープンソース化されています。