r_huijts_firstcycling_api

r_huijts_firstcycling_api

by r-huijts
An MCP server that provides professional cycling data from FirstCycling, including rider information and race results.

FirstCycling MCP Server: Professional Cycling Data Integration

Overview

The FirstCycling MCP Server is a Model Context Protocol (MCP) server designed to provide comprehensive professional cycling data from FirstCycling. It enables users to retrieve detailed information about professional cyclists, race results, historical data, and more. This server is particularly useful for sports analysts, journalists, and cycling enthusiasts who need access to structured and reliable cycling data.

Features

The server offers the following capabilities:

  • Rider Information: Retrieve biographical details, career results, team history, and performance metrics for professional cyclists.
  • Race Data: Access race results, stage profiles, startlists, and historical race statistics.
  • Search Tools: Search for riders and races by name, returning IDs and basic information.
  • Performance Analysis: Analyze rider performance in specific race categories like Grand Tours and Monument classics.
  • Historical Comparisons: Compare rider results and career progression over time.

Real-World Use Cases

Rider Analysis

  • Track a rider's performance in specific races or over their career.
  • Analyze career progression, team history, and specialization in race types.
  • Compare historical results between riders.

Race Research

  • Retrieve recent race results and stage profiles.
  • Explore historical context, such as youngest and oldest winners of specific races.
  • Analyze team compositions and startlists for major races.

Sports Journalism

  • Create detailed rider profiles for articles.
  • Write race previews based on recent results and rider performance.
  • Analyze career evolution using historical data.

Cycling Education

  • Explain the significance of major races using historical data.
  • Summarize the career progression of professional cyclists.
  • Educate about the structure and importance of Grand Tours and Monument classics.

Requirements

  • Python 3.10 or higher
  • uv package manager (recommended)
  • Dependencies listed in pyproject.toml, including:
  • mcp
  • beautifulsoup4
  • lxml
  • pandas
  • slumber

Setup

  1. Clone the repository:
    bash git clone https://github.com/r-huijts/firstcycling-mcp.git
  2. Create and activate a virtual environment:
    bash uv venv source .venv/bin/activate # On macOS/Linux .venv\Scripts\activate # On Windows
  3. Install dependencies:
    bash uv pip install -e .

MCP Tools

Rider Information

Tool Description
get_rider_info Retrieve biographical information about a rider.
get_rider_best_results Get a rider's best career results.
get_rider_grand_tour_results Retrieve results in Grand Tours.
get_rider_monument_results Get results in Monument classics.
get_rider_team_and_ranking Access team history and UCI ranking evolution.
get_rider_race_history Retrieve complete race participation history.
get_rider_victories List career victories with optional filters.

Race Information

Tool Description
get_race_results Retrieve results for a specific race edition.
get_race_overview Get general information about a race.
get_race_stage_profiles Access stage profiles for multi-stage races.
get_race_startlist Retrieve startlists for specific race editions.
get_race_victory_table Show all-time victory tables for races.

Search Tools

Tool Description
search_rider Search for riders by name.
search_race Search for races by name.

Usage

Development Mode

Run the server with MCP Inspector:

uv run mcp dev firstcycling.py

Integration with Claude for Desktop

  1. Edit the Claude for Desktop config file:
  2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%\Claude\claude_desktop_config.json
  4. Add the server configuration:
    json { "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } }
  5. Restart Claude for Desktop.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

The FirstCycling MCP Server is a powerful tool for accessing and analyzing professional cycling data. It integrates seamlessly with tools like Claude for Desktop, making it a valuable resource for cycling enthusiasts and professionals alike.

Resources

Features & Capabilities

Categories
mcp_server model_context_protocol python cycling api_integration data_analysis claude

Implementation Details

View on GitHub

Stats

0 Views
1 GitHub Stars

Repository Info

r-huijts Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI