FirstCycling MCP Server

FirstCycling MCP 服务

这是一个 Model Context Protocol（MCP）服务，可提供 FirstCycling 的职业自行车赛事数据。你可以借助它获取职业自行车选手、比赛结果、比赛详情和历史自行车赛事数据等全面信息。

功能

此 MCP 服务提供丰富的职业自行车赛事数据，可使用以下工具：

• 查找职业自行车选手的信息
• 获取比赛结果和详情
• 探索历史比赛数据
• 分析选手表现和职业生涯发展
• 获取自行车车队和赛事的信息

实际应用场景

借助此 MCP 服务，你可以使用 Claude 来：

选手分析

• 表现追踪：“Tadej Pogačar 这些年来在环法自行车赛中的表现如何？”
• 职业生涯发展：“展示 Wout van Aert 的车队历史和职业生涯发展。”
• 专项分析：“Mathieu van der Poel 在古典赛 Monument 中的成绩如何？”
• 胜利分析：“列出 Jonas Vingegaard 获得的所有 WorldTour 冠军。”
• 历史对比：“比较 Primož Roglič 和 Jonas Vingegaard 在大环赛中的成绩。”

比赛研究

• 近期成绩：“展示 2023 年巴黎-鲁贝的比赛结果。”
• 历史背景：“环弗兰德斯赛最年轻和最年长的冠军分别是谁？”
• 车队分析：“获取 2023 年环法自行车赛的参赛名单及详细车队信息。”
• 比赛统计：“展示列日-巴斯通-列日赛的冠军榜。谁夺冠次数最多？”
• 赛段信息：“可以展示 2023 年环意自行车赛的赛段路线图吗？”

体育新闻报道

• “为自行车杂志文章撰写 Remco Evenepoel 的详细简介。”
• “根据 Tadej Pogačar 和 Jonas Vingegaard 等顶尖选手近期的成绩，为即将到来的环法自行车赛撰写前瞻。”
• “根据 Tom Pidcock 的比赛成绩和车队历史，分析其职业生涯的发展。”

自行车运动教育

• “结合古典赛 Monument 的历史和冠军数据，解释这类比赛的特别之处。”
• “撰写一篇教育性摘要，介绍大环赛及其在职业自行车运动中的重要意义。”
• “结合数据中的案例，描述职业自行车选手的典型职业发展历程。”

要求

• Python 3.10 或更高版本
• uv 包管理器（推荐）
• pyproject.toml 中列出的依赖项，包括：
  • mcp
  • beautifulsoup4
  • lxml
  • pandas
  • slumber
  • 以及其他用于网页抓取和数据处理的软件包

设置

1. 克隆此仓库
2. 创建并激活虚拟环境：

   uv venv
   source .venv/bin/activate  # On macOS/Linux
   # or
   .venv\Scripts\activate  # On Windows
   

3. 安装依赖项：

   uv pip install -e .
   

FirstCycling API

此服务使用 FirstCycling API，该 API 已直接集成到项目中。它通过网页抓取的方式提供从 FirstCycling 网站获取数据的方法。

MCP 工具

此服务通过 Model Context Protocol 提供以下工具：

车手信息

工具	描述
get_rider_info	获取车手的基本个人信息，包括国籍、出生日期、体重、身高和当前车队
get_rider_best_results	获取车手职业生涯中的最佳成绩，并按重要性排序
get_rider_grand_tour_results	获取车手在大环赛（Tour de France、Giro d'Italia、Vuelta a España）中的成绩
get_rider_monument_results	获取车手在自行车赛五大古典赛中的成绩
get_rider_team_and_ranking	获取车手的车队历史记录和 UCI 排名变化
get_rider_race_history	获取车手完整的参赛历史记录，可按年份筛选
get_rider_one_day_races	获取车手单日赛的成绩，可按年份筛选
get_rider_stage_races	获取车手多日分段赛的成绩，可按年份筛选
get_rider_teams	获取车手职业生涯中的完整车队历史记录
get_rider_victories	获取车手职业生涯的胜利列表，可选择筛选 WorldTour 或 UCI 赛事

赛事信息

工具	描述
get_race_results	根据赛事 ID 和年份获取特定届赛事的成绩
get_race_overview	获取赛事的概况，包括历史、纪录和历届冠军
get_race_stage_profiles	获取多赛段赛事的赛段资料和详情
get_race_startlist	获取特定届赛事的参赛名单，包含详细或基本的车队信息
get_race_victory_table	获取赛事历届胜利榜，显示获胜次数最多的车手
get_race_year_by_year	获取赛事逐年成绩，可选择按分类筛选
get_race_youngest_oldest_winners	获取赛事最年轻和最年长冠军的信息
get_race_stage_victories	获取多赛段赛事中赛段胜利的信息

搜索工具

工具	描述
search_rider	按姓名搜索车手，返回其 ID 和基本信息
search_race	按名称搜索赛事，返回其 ID 和基本信息

使用方法

开发模式

运行以下命令，即可使用 MCP Inspector 测试服务：

uv run mcp dev firstcycling.py

这会启动服务并在浏览器中打开 MCP Inspector，让你测试可用工具。

与 Claude for Desktop 集成

将此服务与 Claude for Desktop 集成：

1. 编辑 Claude for Desktop 配置文件，文件位于：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 将服务添加到配置中：

   {
     "mcpServers": {
       "firstcycling": {
         "command": "uv",
         "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"]
       }
     }
   }
   

3. 重启 Claude for Desktop

许可证

MIT