FirstCycling MCP Server
FirstCycling MCP サーバー
FirstCyclingのプロサイクリングデータを提供するモデルコンテキストプロトコル(MCP)サーバーです。プロサイクリスト、レース結果、レース詳細、過去のサイクリングデータに関する包括的な情報を取得できます。
特徴
この MCP サーバーは、プロのサイクリング データへの豊富なアクセスを提供し、次のツールを提供します。
プロサイクリストの情報を探す
レース結果と詳細の取得
過去のレースデータの調査
ライダーのパフォーマンスとキャリアの進歩を分析する
サイクリングチームや競技に関する情報にアクセスする
Related MCP server: Pitstop
実際のユースケース
この 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ツール
サーバーは、モデル コンテキスト プロトコルを通じて次のツールを公開します。
ライダー情報
道具 | 説明 |
| ライダーの国籍、生年月日、体重、身長、現在のチームなど、基本的な経歴情報を取得します。 |
| ライダーのキャリアにおける最高の結果を重要度順に表示します |
| グランツール(ツール・ド・フランス、ジロ・ディ・イタリア、ブエルタ・ア・エスパーニャ)でのライダーの結果を取得します |
| サイクリングのモニュメントクラシックにおけるライダーの結果を取得する |
| ライダーのチーム履歴とUCIランキングの推移を時系列で確認 |
| ライダーの完全なレース参加履歴を取得します。オプションで年別にフィルタリングできます。 |
| ライダーの1日レースの結果を取得します。オプションで年別にフィルタリングできます。 |
| 複数日間のステージレースでのライダーの結果を取得します。オプションで年別にフィルタリングできます。 |
| ライダーのキャリア全体にわたるチーム履歴をすべて取得する |
| ライダーのキャリア勝利リストを取得し、ワールドツアーまたはUCIレースのオプションフィルターを使用します |
レース情報
道具 | 説明 |
| レースIDと年で特定のレースの結果を取得します |
| レースの歴史、記録、過去の優勝者など、レースに関する一般的な情報を入手します |
| マルチステージレースのステージプロファイルと詳細を取得します |
| 特定のレースエディションのスタートリストを、チームの詳細または基本情報とともに取得します |
| 最も多くの勝利を収めたライダーを示すレースの歴代勝利表を取得します |
| オプションの分類フィルターを使用して、レースの年ごとの結果を取得します |
| レースの最年少優勝者と最年長優勝者に関する情報を取得する |
| マルチステージレースのステージ勝利に関する情報を取得する |
検索ツール
道具 | 説明 |
| 名前でライダーを検索し、IDと基本情報を返します |
| レース名で検索し、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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
サーバーを構成に追加します。
{ "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } }デスクトップ版のClaudeを再起動
ライセンス
マサチューセッツ工科大学
Available Tools
18 toolsget_race_detailsA
Get comprehensive details about a cycling race. This tool provides detailed information about a specific race, including its history, key statistics, route details, and other relevant information. The data can be filtered by specific classification.
Note: If you don't know the race's ID, use the search_race tool first to find it by name.
Example usage:
- Get details for Tour de France (ID: 17)
- Get details for Paris-Roubaix (ID: 30)
Returns a formatted string with:
- Race name, country, and category
- Historical information and key statistics
- Course details and characteristics
- Optional classification detailsInputs: race_id (required), classification_num.
get_race_edition_resultsA
Get detailed results for a specific edition of a cycling race. This tool provides comprehensive results for a particular edition of a race, including rankings, time gaps, and other relevant statistics. Results can be filtered by classification or stage.
Note: If you don't know the race's ID, use the search_race tool first to find it by name.
Example usage:
- Get 2023 Tour de France general classification results (Race ID: 17, Year: 2023)
- Get 2022 Paris-Roubaix results (Race ID: 30, Year: 2022)
- Get results for stage 5 of 2023 Tour de France (Race ID: 17, Year: 2023, Stage: 5)
Returns a formatted string with:
- Race name, year, and category
- Complete result list with rankings and time gaps
- Rider names and teams
- Classification or stage specific informationInputs: race_id (required), year (required), classification_num, stage_num.
get_race_victory_tableA
Get the all-time victory table for a cycling race. This tool provides a historical summary of the most successful riders in a specific race, showing the number of victories for each rider throughout the race's history.
Note: If you don't know the race's ID, use the search_race tool first to find it by name.
Example usage:
- Get victory table for Tour de France (ID: 17)
- Get victory table for Paris-Roubaix (ID: 30)
Returns a formatted string with:
- Race name
- List of riders with the most victories
- Number of victories for each rider
- Years of victories where availableInputs: race_id (required).
get_rider_best_resultsA
Retrieve the best career results of a professional cyclist, including their top finishes in various races. This tool provides a comprehensive overview of a rider's most significant achievements throughout their career, including their highest positions in major races, stage wins, and overall classifications. Results are sorted by importance and include detailed information about each race.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get top 10 best results for Tadej Pogačar (ID: 16973)
- Get top 5 best results for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- Rider's name and career highlights
- Top results sorted by importance
- Race details including category and country
- Date and position for each resultInputs: rider_id (required), limit.
get_rider_grand_tour_resultsA
Get comprehensive results for a rider in Grand Tours (Tour de France, Giro d'Italia, and Vuelta a España). This tool provides detailed information about a rider's performance in cycling's most prestigious three-week races, including their overall classification positions, stage wins, and special classification results. The data is organized chronologically and includes all relevant race details.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get Grand Tour results for Tadej Pogačar (ID: 16973)
- Get Grand Tour results for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- Results for each Grand Tour (Tour de France, Giro, Vuelta)
- Overall classification positions
- Stage wins and special classification results
- Time gaps and race detailsInputs: rider_id (required).
get_rider_infoA
Get comprehensive information about a professional cyclist including their current team, nationality, date of birth, and recent race results. This tool provides a detailed overview of a rider's current status and recent performance in professional cycling races. The information includes their current team affiliation, nationality, age, and their most recent race results with positions and times.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get basic info for Tadej Pogačar (ID: 16973)
- Get basic info for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- Full name and current team
- Nationality and date of birth
- UCI ID and social media handles
- Last 5 race results with positions and times
- Total number of UCI victoriesInputs: rider_id (required).
get_rider_monument_resultsA
Retrieve detailed results for a rider in cycling's five Monument races (Milan-San Remo, Tour of Flanders, Paris-Roubaix, Liège-Bastogne-Liège, and Il Lombardia). These are the most prestigious one-day races in professional cycling. The tool provides comprehensive information about a rider's performance in these historic races, including their positions, times, and any special achievements.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get Monument results for Tadej Pogačar (ID: 16973)
- Get Monument results for Mathieu van der Poel (ID: 16975)
Returns a formatted string with:
- Results for each Monument race
- Position and time for each participation
- Race details and special achievements
- Chronological organization by yearInputs: rider_id (required).
get_rider_one_day_racesA
Get a rider's results in one-day races, optionally filtered by year. This tool retrieves detailed information about a rider's performance in one-day races (classics and one-day events). It provides comprehensive data about positions, times, and race categories. Results can be filtered by a specific year.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get one-day race results for Mathieu van der Poel (ID: 16672)
- Get 2023 one-day race results for Wout van Aert (ID: 16948)
Returns a formatted string with:
- Results in one-day races organized by year
- Position and time for each race
- Race category and details
- Chronological organizationInputs: rider_id (required), year.
get_rider_race_historyA
Get the complete race history of a professional cyclist, optionally filtered by year. This tool retrieves a comprehensive list of all races the rider has participated in, including their positions, times, and race categories. It provides a detailed overview of their racing career.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get complete race history for Tadej Pogačar (ID: 16973)
- Get 2023 race history for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- All races organized by year
- Position and time for each race
- Race category and details
- Chronological organizationInputs: rider_id (required), year.
get_rider_stage_racesA
Get a rider's results in stage races, optionally filtered by year. This tool retrieves detailed information about a rider's performance in stage races (multi-day races like Tour de France, Giro d'Italia, etc.). It provides comprehensive data about positions, times, and race categories. Results can be filtered by a specific year.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get stage race results for Tadej Pogačar (ID: 16973)
- Get 2023 stage race results for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- Results in stage races organized by year
- Position and time for each race
- Race category and details
- Chronological organizationInputs: rider_id (required), year.
get_rider_team_and_rankingA
Get information about a professional cyclist's team affiliations and UCI rankings throughout their career. This tool retrieves the rider's team history and their UCI ranking points over time. It provides a comprehensive overview of their professional career progression through different teams and their performance in the UCI rankings.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get team and ranking history for Tadej Pogačar (ID: 16973)
- Get team and ranking history for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- Complete team history with years
- UCI ranking positions and points
- Career progression timeline
- Current team and ranking statusInputs: rider_id (required).
get_rider_teamsA
Get a detailed history of a professional cyclist's team affiliations throughout their career. This tool provides a chronological list of all teams the rider has been part of, including years and team details.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get team history for Peter Sagan (ID: 12345)
- Get career team changes for Chris Froome (ID: 67890)
Returns a formatted string with:
- Complete team history
- Years with each team
- Team names and details
- Chronological organizationInputs: rider_id (required).
get_rider_victoriesA
Get a comprehensive list of a rider's UCI victories. This tool retrieves detailed information about all UCI-registered race victories achieved by the cyclist throughout their career. Victories can be filtered to show only WorldTour wins if desired.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get all UCI victories for Tadej Pogačar (ID: 16973)
- Get WorldTour victories for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- Complete list of victories
- Race details including category
- Date and year of each victory
- Option to filter by WorldTour races onlyInputs: rider_id (required), world_tour_only.
get_rider_year_resultsA
Retrieve detailed results for a professional cyclist for a specific year. This tool provides comprehensive information about a rider's performance in all races during a given calendar year. It includes positions achieved, race categories, dates, and additional details.
Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.
Example usage:
- Get 2023 results for Tadej Pogačar (ID: 16973)
- Get 2022 results for Jonas Vingegaard (ID: 16974)
Returns a formatted string with:
- Complete results for the specified year
- Position and time for each race
- Race category and details
- Chronological organization by dateInputs: rider_id (required), year (required).
get_start_listA
Get the start list for a specific edition of a cycling race. The start list includes rider numbers, names, and teams.
Note: If you don't know the race's ID, use the search_race tool first to find it by name.
If no year is specified, the current year will be used.
Example usage:
- Get start list for current year's Tour de France (Race ID: 17)
- Get start list for 2023 Paris-Roubaix (Race ID: 30, Year: 2023)
Returns a formatted string with:
- Race name and year
- List of participating teams
- Riders for each team with their race numbersInputs: race_id (required), year.
get_uci_rankingsB
Get UCI rankings for riders, teams, or nations. This tool provides access to the UCI ranking data for professional cyclists, teams, or nations. Results can be filtered by ranking type, year, and category.
Example usage:
- Get World UCI rider rankings for 2023
- Get Europe Tour UCI team rankings for 2022
- Get UCI nation rankings for 2023 in the World category
Returns a formatted string with:
- Ranking list with positions and points
- Filtered by specified categories
- Organized in a readable format
- Option to filter by countryInputs: category, country_code, page_num, rank_type, +1 more.
search_raceA
Search for cycling races by name. This tool helps find races by their name, returning a list of matching races with their IDs and countries. This is useful when you know a race's name but need its ID for other operations.
Example usage:
- Search for "tour" to find Tour de France and other tours
- Search for "giro" to find Giro d'Italia
Returns a formatted string with:
- List of matching races
- Each race's ID, name, and country
- Number of matches foundInputs: query (required).
search_riderA
Search for professional cyclists by name. This tool helps find riders by their name, returning a list of matching riders with their IDs and basic information. This is useful when you need a rider's ID for other operations but only know their name.
Example usage:
- Search for "Tadej Pogacar" to find Tadej Pogačar's ID
- Search for "Van Aert" to find Wout van Aert's ID
Returns a formatted string with:
- List of matching riders
- Each rider's ID, name, nationality, and current team
- Number of matches foundInputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
The tools have clear distinctions between race-focused and rider-focused operations, but there is significant overlap within rider tools. For example, get_rider_best_results, get_rider_grand_tour_results, get_rider_monument_results, get_rider_one_day_races, get_rider_race_history, get_rider_stage_races, and get_rider_year_results all retrieve subsets of race results, which could confuse an agent about which to use for specific queries. The descriptions help differentiate, but the boundaries are fuzzy.
All tool names follow a consistent snake_case pattern with a verb_noun structure (e.g., get_race_details, search_rider). The naming is predictable and readable throughout, with no deviations in style or convention, making it easy for an agent to parse and understand the tool purposes.
With 18 tools, the count is on the higher side for a cycling data server, bordering on heavy. While the domain of professional cycling is broad, the tool set includes many overlapping rider result tools that could potentially be consolidated, making it feel slightly bloated but still within a reasonable scope.
The tool surface covers the cycling domain well with race details, results, rider information, and search functionalities. However, there are minor gaps, such as no tools for team details beyond rider affiliations, race calendars, or live race data, which agents might need for comprehensive coverage. The core operations are well-represented, allowing agents to work around these omissions.
Related MCP Connectors
Free web search, 130M+ business records, local search, weather and travel data for AI agents.
Paid web research, news, company briefs, fact-checks and US weather data for AI agents
Data and tools for your AI agent: company, people, SEO, social and EU register data. Pay per call.
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides comprehensive Formula 1 data access including race schedules, session results, lap times, telemetry data, driver/constructor standings, and circuit information. Enables users to retrieve and analyze F1 racing data through natural language queries using the FastF1 Python package.5MIT
- AlicenseAqualityBmaintenanceProvides access to Formula 1 data including driver and constructor championship standings with support for current and historical seasons. Enables users to query F1 championship information through natural language with plans for expanded race data and telemetry.2211 PyPI1MIT
- AlicenseAqualityDmaintenanceProvides professional cycling data from ProCyclingStats, enabling race discovery, stage results, rider profiles, startlists, and free-text search through MCP tools.63-
- FlicenseNot gradedqualityDmaintenanceMCP server exposing ProCyclingStats teams, riders, and races data by scraping site pages, enabling custom rankings and historical result analysis.-