FirstCycling MCP Server
Servidor MCP de FirstCycling
Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos de ciclismo profesional de FirstCycling. Permite recuperar información completa sobre ciclistas profesionales, resultados y detalles de carreras, y datos históricos de ciclismo.
Características
Este servidor MCP ofrece un amplio acceso a datos de ciclismo profesional y proporciona herramientas para:
Encontrar información sobre ciclistas profesionales
Recuperación de resultados y detalles de la carrera
Explorando datos históricos de carreras
Análisis del rendimiento del ciclista y su progresión profesional
Acceder a información sobre equipos y competiciones ciclistas
Related MCP server: Pitstop
Casos de uso del mundo real
Con este servidor MCP, puedes usar Claude para:
Análisis del jinete
Seguimiento del rendimiento : "¿Cómo se ha desempeñado Tadej Pogačar en el Tour de Francia a lo largo de los años?"
Progresión profesional : "Muéstrame la historia del equipo y la progresión profesional de Wout van Aert".
Análisis de especialización : "¿Cuáles son los resultados de Mathieu van der Poel en Clásicos Monumento?"
Análisis de la victoria : "Enumere todas las victorias del WorldTour de Jonas Vingegaard".
Comparación histórica : "Compare los resultados del Gran Tour de Primož Roglič y Jonas Vingegaard".
Investigación racial
Resultados recientes : "Muéstrame los resultados de la París-Roubaix 2023".
Contexto histórico : "¿Quiénes son los ganadores más jóvenes y más viejos del Tour de Flandes?"
Análisis del equipo : "Consulta la lista de salida del Tour de Francia 2023 con información detallada del equipo".
Estadísticas de la carrera : "¿Qué tabla de victorias tiene la Lieja-Bastoña-Lieja? ¿Quién la ha ganado más veces?"
Información de la etapa : "¿Puedes mostrarme los perfiles de las etapas del Giro de Italia 2023?"
Periodismo deportivo
"Crear un perfil detallado de Remco Evenepoel para un artículo de una revista de ciclismo".
"Escribe una previa del próximo Tour de Francia basándote en los resultados recientes de los principales contendientes como Tadej Pogačar y Jonas Vingegaard".
"Analice la evolución de la carrera de Tom Pidcock en función de sus resultados en carreras y su historial con el equipo".
Educación sobre ciclismo
"Explique qué hace que los clásicos del Monument sean especiales utilizando datos sobre su historia y sus ganadores".
"Crear un resumen educativo sobre las Grandes Vueltas y su importancia en el ciclismo profesional".
"Describe la progresión profesional típica de un ciclista profesional utilizando ejemplos de los datos".
Requisitos
Python 3.10 o superior
Gestor de paquetes
uv(recomendado)Dependencias enumeradas en
pyproject.toml, incluidas:mcp
beautifulsoup4
lxml
pandas
sueño
y otros paquetes para el raspado web y el procesamiento de datos
Configuración
Clonar este repositorio
Crear y activar un entorno virtual:
uv venv source .venv/bin/activate # On macOS/Linux # or .venv\Scripts\activate # On WindowsInstalar dependencias:
uv pip install -e .
API de FirstCycling
Este servidor utiliza la API de FirstCycling , integrada directamente en el proyecto. Esta API proporciona métodos para extraer datos del sitio web de FirstCycling mediante web scraping.
Herramientas MCP
El servidor expone las siguientes herramientas a través del Protocolo de Contexto de Modelo:
Información para el pasajero
Herramienta | Descripción |
| Obtenga información biográfica básica sobre un ciclista, incluida la nacionalidad, la fecha de nacimiento, el peso, la altura y el equipo actual. |
| Recuperar los mejores resultados de la carrera de un ciclista, ordenados por importancia |
| Obtener los resultados de un ciclista en Grandes Vueltas (Tour de Francia, Giro de Italia, Vuelta a España) |
| Recuperar los resultados de un ciclista en las clásicas de ciclismo Monument |
| Obtenga el historial del equipo de un ciclista y la evolución de la clasificación UCI a lo largo del tiempo |
| Recupere el historial completo de participación en carreras de un ciclista, opcionalmente filtrado por año |
| Obtenga los resultados de un ciclista en carreras de un día, opcionalmente filtrados por año |
| Obtén los resultados de un ciclista en carreras por etapas de varios días, opcionalmente filtrados por año |
| Recuperar el historial completo del equipo de un ciclista a lo largo de su carrera |
| Obtenga una lista de las victorias de la carrera de un ciclista, con filtros opcionales para carreras WorldTour o UCI |
Información de la carrera
Herramienta | Descripción |
| Recuperar resultados para una edición de carrera específica por ID de carrera y año |
| Obtenga información general sobre una carrera, incluyendo historial, récords y ganadores anteriores. |
| Recuperar perfiles de etapas y detalles para carreras de varias etapas |
| Obtén la lista de salida para una edición de carrera específica con información detallada o básica del equipo |
| Recupere la tabla de victorias de todos los tiempos de una carrera que muestra a los corredores con más victorias |
| Obtenga resultados año tras año para una carrera con filtro de clasificación opcional |
| Recuperar información sobre los ganadores más jóvenes y mayores de una carrera |
| Obtén información sobre las victorias de etapa en carreras de varias etapas |
Herramientas de búsqueda
Herramienta | Descripción |
| Busque pasajeros por nombre, devolviendo sus identificaciones e información básica |
| Busque razas por nombre, devolviendo sus identificaciones e información básica |
Uso
Modo de desarrollo
Puede probar el servidor con MCP Inspector ejecutando:
uv run mcp dev firstcycling.pyEsto iniciará el servidor y abrirá el Inspector MCP en su navegador, lo que le permitirá probar las herramientas disponibles.
Integración con Claude para escritorio
Para integrar este servidor con Claude for Desktop:
Edite el archivo de configuración de Claude for Desktop, ubicado en:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonVentanas:
%APPDATA%\Claude\claude_desktop_config.json
Añade el servidor a tu configuración:
{ "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } }Reiniciar Claude para escritorio
Licencia
Instituto Tecnológico de Massachusetts (MIT)
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.-