MCP-Soccerdata MCP サーバー

「MCP-Soccerdata」MCP サーバーとは？

MCP-Soccerdata は、SoccerDataAPI に接続して自然言語で最新のサッカー（フットボール）試合情報を提供する、オープンソースの Model Context Protocol (MCP) サーバーです。Claude Desktop などの MCP 対応クライアントと組み合わせることで、ユーザーや AI アシスタントが大規模言語モデル（LLM）を活用して、構造化されたリアルタイムのサッカーデータを取得できます。サーバーは進行中の試合インサイト、試合リスト、チームラインナップ、主な試合イベント、ベッティングオッズ、リーグメタデータを提供します。この連携によって、サッカーデータのクエリ、開発、研究、ファンエンゲージメント体験がより豊かになります。

プロンプト一覧

リポジトリには明示的なプロンプトテンプレートの記載はありません。

リソース一覧

• ライブ試合リスト
  現在進行中の全世界のサッカー試合を一覧で提供。チーム名、キックオフ時間、スタジアム情報、現時点のスコアも含みます。
• 試合詳細
  試合状況（予定・進行中・終了）、得点内訳、最終結果などの情報を提供します。
• 主な試合イベント
  各試合のゴール、選手交代、イエロー／レッドカード、ペナルティなどの構造化データを配信します。
• チームラインナップ
  先発メンバー、ベンチ、負傷者情報、チームフォーメーションなどを提供します。

ツール一覧

ドキュメントやリポジトリ内に明示的なツールリストや server.py の詳細はありません。

この MCP サーバーのユースケース

• ライブサッカー試合モニタリング
  開発者や AI エージェントが世界中の進行中サッカー試合の最新データを取得できます。
• 自動スポーツレポート作成
  メディアやファンサイト向けに、試合サマリー・イベント内訳・ラインナップ解析などを自動生成。
• ファンエンゲージメントボット
  ライブスコア、次の試合、選手データ等の質問に答えるチャットボットの裏側をサポート。
• ベッティング分析アプリケーション
  リアルタイムのオッズや試合データをベッティング推奨・分析ツールに統合。
• リーグ・トーナメント追跡
  各種リーグ・大会の順位、試合結果、統計をダッシュボードで管理。

セットアップ方法

Windsurf

1. Node.js と Windsurf をインストールしてください。
2. Windsurf の設定ファイル（例: windsurf.json）を探します。
3. mcpServers セクションに次の JSON スニペットを追加します:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. 設定を保存し Windsurf を再起動します。
5. サーバーが稼働しているか確認します。

Claude

1. Claude Desktop をインストールし、最新版であることを確認します。
2. Claude の設定ファイル（OS により場所が異なります）を開きます。
3. mcpServers セクションに MCP-Soccerdata サーバーを追加します:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. 保存して Claude Desktop を再起動します。
5. Claude インターフェイスで接続が成功しているか確認。

Cursor

1. Cursor IDE と Node.js をインストールします。
2. ワークスペース内で .cursorconfig ファイルを作成または開きます。
3. サーバー設定を挿入します:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. 保存して Cursor を再読み込みします。
5. 拡張機能パネルに MCP サーバーが表示されているか確認。

Cline

1. Cline ターミナルクライアントをインストールします。
2. .cline.json 設定ファイルを開きます。
3. 次の設定を追加します:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. 保存して Cline を再起動します。
5. cline mcp list コマンドで接続を確認します。

API キーの安全な管理

機密性の高い API キーは環境変数として保存し、設定ファイルの env フィールド経由で渡します。例:

{
  "mcpServers": {
    "soccerdata": {
      "command": "npx",
      "args": ["@yeonupark/mcp-soccer-data@latest"],
      "env": {
        "SOCCERDATA_API_KEY": "${SOCCERDATA_API_KEY}"
      },
      "inputs": {
        "apiKey": "${SOCCERDATA_API_KEY}"
      }
    }
  }
}

フロー内での MCP 利用方法

FlowHunt での MCP 利用

FlowHunt のワークフローに MCP サーバーを統合するには、MCP コンポーネントをフローに追加し、AI エージェントに接続してください。

MCP コンポーネントをクリックして設定パネルを開きます。システム MCP 設定セクションで、以下の JSON フォーマットで MCP サーバー詳細を入力します:

{
  "MCP-Soccerdata": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AI エージェントはこの MCP の全ての機能をツールとして利用できるようになります。“MCP-Soccerdata” の部分はご自身の MCP サーバー名、URL も実際のものに変更してください。

概要

当社の見解

MCP-Soccerdata は、リソース内容とセットアップガイドが充実したリアルタイムサッカーデータサーバーです。ただし、プロンプトテンプレートや明確なツール定義が不足しているため、高度な MCP ワークフローでの柔軟性や開発者採用面でやや物足りなさがあります。

MCP スコア

上記の内容をふまえ、この MCP サーバーの評価は 5/10 です。サッカーデータのコア機能やドキュメントは充実している一方、プロンプトテンプレートやツールリスト、サンプリング・roots など高度な統合機能は不十分です。