FirstCycling MCP サーバー

FirstCyclingのプロサイクリングデータを提供するモデルコンテキストプロトコル（MCP）サーバーです。プロサイクリスト、レース結果、レース詳細、過去のサイクリングデータに関する包括的な情報を取得できます。

特徴

この MCP サーバーは、プロのサイクリングデータへの豊富なアクセスを提供し、次のツールを提供します。

プロサイクリストの情報を探す
レース結果と詳細の取得
過去のレースデータの調査
ライダーのパフォーマンスとキャリアの進歩を分析する
サイクリングチームや競技に関する情報にアクセスする

実際のユースケース

この MCP サーバーを使用すると、Claude を使用して次のことが可能になります。

ライダー分析

パフォーマンス追跡：「タデイ・ポガチャルはこれまでツール・ド・フランスでどのような成績を残してきたのか？」
キャリアの進捗: 「ワウト・ファン・アールトのチームの歴史とキャリアの進捗を教えてください。」
専門分野分析：「モニュメントクラシックにおけるマチュー・ファンデルプールの成績は？」
勝利分析：「ジョナス・ヴィンゲガードのワールドツアーでの勝利をすべてリストアップしてください。」
歴史的な比較: 「プリモシュ・ログリッチとヨナス・ヴィンゲガードのグランツール成績を比較」

人種研究

最近の結果：「2023年のパリ〜ルーベの結果を見せてください。」
歴史的背景：「フランドル・ツアーの最年少優勝者と最年長優勝者は誰ですか？」
チーム分析：「2023 年のツール・ド・フランスのスタートリストを詳細なチーム情報とともに入手してください。」
レース統計：「リエージュ〜バストーニュ〜リエージュの優勝順位表を見せてください。最も多く優勝したのは誰ですか？」
ステージ情報：「2023年ジロ・デ・イタリアのステージプロファイルを見せてもらえますか？」

スポーツジャーナリズム

「サイクリング雑誌の記事のために、レムコ・エヴェネプールの詳細なプロフィールを作成してください。」
「タデイ・ポガチャルやヨナス・ヴィンゲゴーアのようなトップ候補の最近の結果に基づいて、来たるツール・ド・フランスのプレビューを書いてください。」
「トム・ピッドコックのレース結果とチームの歴史に基づいて、彼のキャリアの進化を分析します。」

サイクリング教育

「モニュメントクラシックの歴史と優勝者に関するデータを使用して、モニュメントクラシックの特別な点を説明します。」
「グランツールとプロサイクリングにおけるその重要性についての教育的な要約を作成します。」
「データの例を使用して、プロの自転車競技者の典型的なキャリアの進行について説明します。」

要件

Python 3.10以上
uvパッケージマネージャー (推奨)
pyproject.tomlにリストされている依存関係には以下が含まれます:
- マクピー
- 美しいスープ4
- lxml
- パンダ
- 眠り
- ウェブスクレイピングとデータ処理のためのその他のパッケージ

設定

このリポジトリをクローンする
仮想環境を作成してアクティブ化します。
uv venv source .venv/bin/activate # On macOS/Linux # or .venv\Scripts\activate # On Windows
依存関係をインストールします:
uv pip install -e .

ファーストサイクリングAPI

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

MCPツール

サーバーは、モデルコンテキストプロトコルを通じて次のツールを公開します。

ライダー情報

道具	説明
`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`	ライダーの1日レースの結果を取得します。オプションで年別にフィルタリングできます。
`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と統合するには:

次の場所にある Claude for Desktop 構成ファイルを編集します。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
サーバーを構成に追加します。
{ "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } }
デスクトップ版のClaudeを再起動

ライセンス

マサチューセッツ工科大学

FirstCycling MCP Server

Integrations