FirstCycling MCP Server

Features

• Finding information about professional cyclists

• Retrieving race results and details

• Exploring historical race data

• Analyzing rider performance and career progression

• Accessing information about cycling teams and competitions

Real-World Use Cases

Rider Analysis

• **Performance Tracking**: "How has Tadej Poga ar performed in the Tour de France over the years?"

• **Career Progression**: "Show me the team history and career progression of Wout van Aert."

• **Specialization Analysis**: "What are Mathieu van der Poel's results in Monument classics?"

• **Victory Analysis**: "List all WorldTour victories for Jonas Vingegaard."

• **Historical Comparison**: "Compare the Grand Tour results of Primo Rogli and Jonas Vingegaard."

Race Research

• **Recent Results**: "Show me the results of the 2023 Paris-Roubaix."

• **Historical Context**: "Who are the youngest and oldest winners of the Tour of Flanders?"

• **Team Analysis**: "Get the startlist for the 2023 Tour de France with detailed team information."

• **Race Statistics**: "Show me the victory table for Li ge-Bastogne-Li ge. Who has won it the most times?"

• **Stage Information**: "Can you show me the stage profiles for the 2023 Giro d'Italia?"

Sports Journalism

• "Create a detailed profile of Remco Evenepoel for a cycling magazine article."

• "Write a preview for the upcoming Tour de France based on the recent results of top contenders like Tadej Poga ar and Jonas Vingegaard."

• "Analyze the evolution of Tom Pidcock's career based on his race results and team history."

Cycling Education

• "Explain what makes the Monument classics special using data about their history and winners."

• "Create an educational summary about Grand Tours and their significance in professional cycling."

• "Describe the typical career progression of a professional cyclist using examples from the data."

Requirements

• Python 3.10 or higher

• `uv` package manager (recommended)

• Dependencies as listed in `pyproject.toml`, including: - mcp - beautifulsoup4 - lxml - pandas - slumber - and other packages for web scraping and data processing

Setup

1. Clone this repository

2. Create and activate a virtual environment: ``` uv venv source .venv/bin/activate # On macOS/Linux # or .venv\Scripts\activate # On Windows ```

3. Install dependencies: ``` uv pip install -e . ```

FirstCycling API

MCP Tools

Rider Information

Race Information

Search Tools

Usage

Development Mode

Integration with Claude for Desktop

1. Edit the Claude for Desktop config file, located at: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json`

2. Add the server to your configuration: ```json { "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } } ```

3. Restart Claude for Desktop

License