FirstCycling MCP Server

MIT License
  • Apple

Integrations

  • Used for processing and analyzing cycling data, including performance statistics, race results, and rider histories from FirstCycling.

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

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

  1. Clonar este repositorio
  2. Crear y activar un entorno virtual:
    uv venv source .venv/bin/activate # On macOS/Linux # or .venv\Scripts\activate # On Windows
  3. Instalar 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

HerramientaDescripción
get_rider_infoObtenga información biográfica básica sobre un ciclista, incluida la nacionalidad, la fecha de nacimiento, el peso, la altura y el equipo actual.
get_rider_best_resultsRecuperar los mejores resultados de la carrera de un ciclista, ordenados por importancia
get_rider_grand_tour_resultsObtener los resultados de un ciclista en Grandes Vueltas (Tour de Francia, Giro de Italia, Vuelta a España)
get_rider_monument_resultsRecuperar los resultados de un ciclista en las clásicas de ciclismo Monument
get_rider_team_and_rankingObtenga el historial del equipo de un ciclista y la evolución de la clasificación UCI a lo largo del tiempo
get_rider_race_historyRecupere el historial completo de participación en carreras de un ciclista, opcionalmente filtrado por año
get_rider_one_day_racesObtenga los resultados de un ciclista en carreras de un día, opcionalmente filtrados por año
get_rider_stage_racesObtén los resultados de un ciclista en carreras por etapas de varios días, opcionalmente filtrados por año
get_rider_teamsRecuperar el historial completo del equipo de un ciclista a lo largo de su carrera
get_rider_victoriesObtenga una lista de las victorias de la carrera de un ciclista, con filtros opcionales para carreras WorldTour o UCI

Información de la carrera

HerramientaDescripción
get_race_resultsRecuperar resultados para una edición de carrera específica por ID de carrera y año
get_race_overviewObtenga información general sobre una carrera, incluyendo historial, récords y ganadores anteriores.
get_race_stage_profilesRecuperar perfiles de etapas y detalles para carreras de varias etapas
get_race_startlistObtén la lista de salida para una edición de carrera específica con información detallada o básica del equipo
get_race_victory_tableRecupere la tabla de victorias de todos los tiempos de una carrera que muestra a los corredores con más victorias
get_race_year_by_yearObtenga resultados año tras año para una carrera con filtro de clasificación opcional
get_race_youngest_oldest_winnersRecuperar información sobre los ganadores más jóvenes y mayores de una carrera
get_race_stage_victoriesObtén información sobre las victorias de etapa en carreras de varias etapas

Herramientas de búsqueda

HerramientaDescripción
search_riderBusque pasajeros por nombre, devolviendo sus identificaciones e información básica
search_raceBusque 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.py

Esto 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:

  1. Edite el archivo de configuración de Claude for Desktop, ubicado en:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
  2. Añade el servidor a tu configuración:
    { "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } }
  3. Reiniciar Claude para escritorio

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Proporciona datos de ciclismo profesionales de FirstCycling, lo que permite a los usuarios recuperar información completa sobre ciclistas, resultados de carreras, datos históricos de ciclismo e información del equipo a través de consultas en lenguaje natural.

  1. Features
    1. Real-World Use Cases
      1. Rider Analysis
      2. Race Research
      3. Sports Journalism
      4. Cycling Education
    2. Requirements
      1. Setup
        1. FirstCycling API
          1. MCP Tools
            1. Rider Information
            2. Race Information
            3. Search Tools
          2. Usage
            1. Development Mode
            2. Integration with Claude for Desktop
          3. License
            ID: lbkjwm0se5