概要
What is FirstCycling?
FirstCycling is a Model Context Protocol (MCP) server that provides professional cycling data from the FirstCycling website. It allows AI assistants to retrieve comprehensive information about professional cyclists, race results, race details, and historical cycling data through web scraping.
How to use FirstCycling?
Clone the repository, create a virtual environment with uv venv, install dependencies with uv pip install -e ., then integrate with Claude Desktop by adding a server entry to the Claude config file (claude_desktop_config.json) pointing to the server directory. Tools are invoked via natural language commands through the MCP interface.
Key features of FirstCycling
- Retrieve rider biographical information and career histories
- Search for riders and races by name
- Access Grand Tour, Monument, and one-day race results
- Get race details including stage profiles and startlists
- Analyze rider performance, team history, and victories
Use cases of FirstCycling
- Track and compare rider performance across Grand Tours and classics
- Research historical race data such as victory tables and youngest/oldest winners
- Create detailed rider profiles for sports journalism or broadcasting
- Prepare race previews and analysis based on recent results
- Educate fans about cycling history and career progression
FAQ from FirstCycling
What are the runtime requirements for FirstCycling?
Python 3.10 or higher and the uv package manager are required. Dependencies are managed in pyproject.toml and include mcp, beautifulsoup4, lxml, pandas, and slumber.
How does FirstCycling get its data?
The server uses the FirstCycling API, which fetches data from the FirstCycling website through web scraping.
What tools does FirstCycling expose?
It provides over 20 MCP tools organized into Rider Information (e.g., get_rider_info, get_rider_grand_tour_results), Race Information (e.g., get_race_results, get_race_startlist), and Search Tools (search_rider, search_race).
Can I test the server before using it with Claude?
Yes. Run uv run mcp dev firstcycling.py to start the server and open the MCP Inspector in your browser for testing tools interactively.
