Skip to main content
Glama
FirstCycling MCP Server

FirstCycling MCP Server

by r-huijts

FirstCycling MCP サーバー

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

特徴

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

  • プロサイクリストの情報を探す

  • レース結果と詳細の取得

  • 過去のレースデータの調査

  • ライダーのパフォーマンスとキャリアの進歩を分析する

  • サイクリングチームや競技に関する情報にアクセスする

Related MCP server: Pitstop

実際のユースケース

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

ライダー分析

  • パフォーマンス追跡:「タデイ・ポガチャルはこれまでツール・ド・フランスでどのような成績を残してきたのか?」

  • キャリアの進捗: 「ワウト・ファン・アールトのチームの歴史とキャリアの進捗を教えてください。」

  • 専門分野分析:「モニュメントクラシックにおけるマチュー・ファンデルプールの成績は?」

  • 勝利分析:「ジョナス・ヴィンゲガードのワールドツアーでの勝利をすべてリストアップしてください。」

  • 歴史的な比較: 「プリモシュ・ログリッチとヨナス・ヴィンゲガードのグランツール成績を比較」

人種研究

  • 最近の結果:「2023年のパリ〜ルーベの結果を見せてください。」

  • 歴史的背景:「フランドル・ツアーの最年少優勝者と最年長優勝者は誰ですか?」

  • チーム分析:「2023 年のツール・ド・フランスのスタートリストを詳細なチーム情報とともに入手してください。」

  • レース統計:「リエージュ〜バストーニュ〜リエージュの優勝順位表を見せてください。最も多く優勝したのは誰ですか?」

  • ステージ情報:「2023年ジロ・デ・イタリアのステージプロファイルを見せてもらえますか?」

スポーツジャーナリズム

  • 「サイクリング雑誌の記事のために、レムコ・エヴェネプールの詳細なプロフィールを作成してください。」

  • 「タデイ・ポガチャルやヨナス・ヴィンゲゴーアのようなトップ候補の最近の結果に基づいて、来たるツール・ド・フランスのプレビューを書いてください。」

  • 「トム・ピッドコックのレース結果とチームの歴史に基づいて、彼のキャリアの進化を分析します。」

サイクリング教育

  • 「モニュメントクラシックの歴史と優勝者に関するデータを使用して、モニュメントクラシックの特別な点を説明します。」

  • 「グランツールとプロサイクリングにおけるその重要性についての教育的な要約を作成します。」

  • 「データの例を使用して、プロの自転車競技者の典型的なキャリアの進行について説明します。」

要件

  • Python 3.10以上

  • uvパッケージ マネージャー (推奨)

  • pyproject.tomlにリストされている依存関係には以下が含まれます:

    • マクピー

    • 美しいスープ4

    • lxml

    • パンダ

    • 眠り

    • ウェブスクレイピングとデータ処理のためのその他のパッケージ

設定

  1. このリポジトリをクローンする

  2. 仮想環境を作成してアクティブ化します。

    uv venv
    source .venv/bin/activate  # On macOS/Linux
    # or
    .venv\Scripts\activate  # On Windows
  3. 依存関係をインストールします:

    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と統合するには:

  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を再起動

ライセンス

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

Available Tools

18 tools
get_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 details

Inputs: 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 information

Inputs: 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 available

Inputs: 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 result

Inputs: 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 details

Inputs: 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 victories

Inputs: 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 year

Inputs: 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 organization

Inputs: 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 organization

Inputs: 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 organization

Inputs: 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 status

Inputs: 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 organization

Inputs: 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 only

Inputs: 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 date

Inputs: 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 numbers

Inputs: 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 country

Inputs: 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 found

Inputs: 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 found

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 18 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides 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.
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      22
      11 PyPI
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides professional cycling data from ProCyclingStats, enabling race discovery, stage results, rider profiles, startlists, and free-text search through MCP tools.
      6
      3
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server exposing ProCyclingStats teams, riders, and races data by scraping site pages, enabling custom rankings and historical result analysis.
      -