FirstCycling MCP Server

FirstCycling MCP サーバー

FirstCycling のプロロードレースのデータを提供する、Model Context Protocol（MCP）サーバーです。プロの自転車選手、レース結果、レースの詳細、過去の自転車競技データに関する包括的な情報を取得できます。

機能

この MCP サーバーでは、以下の用途に役立つプロロードレースのデータに幅広くアクセスできます。

• プロの自転車選手に関する情報の検索
• レース結果や詳細情報の取得
• 過去のレースデータの調査
• 選手のパフォーマンスとキャリアの変遷の分析
• 自転車チームや競技大会に関する情報の取得

実際の活用例

この MCP サーバーを使うと、Claude に次のようなことを依頼できます。

選手分析

• パフォーマンスの追跡：「タデイ・ポガチャルは、これまでツール・ド・フランスでどのような成績を残していますか？」
• キャリアの変遷：「ワウト・ファンアールトのチーム遍歴とキャリアの変遷を見せてください。」
• 専門分野の分析：「モニュメント・クラシックでのマチュー・ファンデルプールの成績を教えてください。」
• 優勝実績の分析：「ヨナス・ヴィンゲゴーのワールドツアーでの優勝をすべて一覧にしてください。」
• 過去の成績の比較：「プリモシュ・ログリッチとヨナス・ヴィンゲゴーのグランツールでの成績を比較してください。」

レースの調査

• 最近の結果：「2023 年のパリ〜ルーベの結果を見せてください。」
• 歴史的な背景：「ツール・デ・フランドルで最年少および最年長の優勝者は誰ですか？」
• チーム分析：「2023 年のツール・ド・フランスの出走者リストを、チームの詳細情報と併せて取得してください。」
• レース統計：「リエージュ〜バストーニュ〜リエージュの優勝者一覧を見せてください。最多優勝者は誰ですか？」
• ステージ情報：「2023 年のジロ・デ・イタリアのステージプロフィールを見せてもらえますか？」

スポーツジャーナリズム

• 「自転車競技雑誌の記事向けに、レムコ・エヴェネプールの詳細なプロフィールを作成してください。」
• 「タデイ・ポガチャルやヨナス・ヴィンゲゴーなど、有力選手の最近の成績をもとに、次回のツール・ド・フランスのプレビューを書いてください。」
• 「トム・ピドコックのレース結果とチーム遍歴をもとに、キャリアの変遷を分析してください。」

自転車競技の学習

• 「モニュメント・クラシックの歴史と優勝者のデータを使って、その特別さを説明してください。」
• 「グランツールとプロ自転車競技におけるその重要性について、学習用の要約を作成してください。」
• 「データの事例を使って、プロの自転車選手に典型的なキャリアの歩みを説明してください。」

要件

• Python 3.10 以上
• uv パッケージマネージャー（推奨）
• pyproject.toml に記載されている依存関係。以下を含みます。
  • mcp
  • beautifulsoup4
  • lxml
  • pandas
  • slumber
  • その他、ウェブスクレイピングとデータ処理用のパッケージ

セットアップ

1. このリポジトリをクローンします
2. 仮想環境を作成して有効化します。

   uv venv
   source .venv/bin/activate  # On macOS/Linux
   # or
   .venv\Scripts\activate  # On Windows
   

3. 依存関係をインストールします。

   uv pip install -e .
   

FirstCycling API

このサーバーはFirstCycling APIを使用しています。この API はプロジェクトに直接統合されています。API では、ウェブスクレイピングを通じて FirstCycling のウェブサイトからデータを取得するメソッドを提供しています。

MCP ツール

このサーバーは、Model Context Protocol を通じて次のツールを公開しています。

選手情報

ツール	説明
get_rider_info	国籍、生年月日、体重、身長、現在のチームなど、選手の基本的なプロフィール情報を取得します
get_rider_best_results	選手のキャリアにおける主な成績を重要度順に取得します
get_rider_grand_tour_results	グランツール（ツール・ド・フランス、ジロ・デ・イタリア、ブエルタ・ア・エスパーニャ）での選手の成績を取得します
get_rider_monument_results	自転車競技のモニュメントクラシックでの選手の成績を取得します
get_rider_team_and_ranking	選手のチーム遍歴と、時系列でのUCIランキングの推移を取得します
get_rider_race_history	年で絞り込むこともできる、選手の全レース出場履歴を取得します
get_rider_one_day_races	年で絞り込むこともできる、ワンデーレースでの選手の成績を取得します
get_rider_stage_races	年で絞り込むこともできる、複数日間のステージレースでの選手の成績を取得します
get_rider_teams	キャリアを通じた選手の全チーム履歴を取得します
get_rider_victories	ワールドツアーまたはUCIレースでの絞り込みにも対応した、選手のキャリアにおける勝利一覧を取得します

レース情報

ツール	説明
get_race_results	レースIDと年を指定して、特定の大会の結果を取得します
get_race_overview	歴史、記録、過去の優勝者など、レースの基本情報を取得します
get_race_stage_profiles	ステージレースの各ステージのプロフィールと詳細を取得します
get_race_startlist	詳細または基本的なチーム情報とともに、特定の大会の出走リストを取得します
get_race_victory_table	優勝回数の多い選手を示す、レースの歴代優勝者一覧を取得します
get_race_year_by_year	分類での絞り込みにも対応した、レースの年別結果を取得します
get_race_youngest_oldest_winners	レースの最年少および最年長の優勝者に関する情報を取得します
get_race_stage_victories	ステージレースにおけるステージ優勝に関する情報を取得します

検索ツール

ツール	説明
search_rider	名前で選手を検索し、IDと基本情報を返します
search_race	名前でレースを検索し、IDと基本情報を返します

使い方

開発モード

次のコマンドを実行すると、MCP Inspectorでサーバーをテストできます。

uv run mcp dev firstcycling.py

これによりサーバーが起動し、ブラウザーでMCP Inspectorが開き、利用可能なツールをテストできます。

Claude for Desktopとの連携

このサーバーをClaude for Desktopと連携するには、次の手順を実行します。

1. 次の場所にあるClaude for Desktopの設定ファイルを編集します。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 設定にサーバーを追加します。

   {
     "mcpServers": {
       "firstcycling": {
         "command": "uv",
         "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"]
       }
     }
   }
   

3. Claude for Desktopを再起動します。

ライセンス

MIT