FirstCycling MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供来自 FirstCycling 的专业自行车数据。它允许您检索有关专业自行车运动员、比赛结果、比赛详情以及历史骑行数据的全面信息。

特征

该 MCP 服务器提供丰富的专业自行车数据访问，并提供以下工具：

查找有关职业自行车手的信息
检索比赛结果和详细信息
探索历史比赛数据
分析骑手的表现和职业发展
获取有关自行车队和比赛的信息

真实用例

使用此 MCP 服务器，您可以使用 Claude 来执行以下操作：

车手分析

表现追踪：“塔德伊·波加查 (Tadej Pogačar) 这些年来在环法自行车赛中的表现如何？”
职业发展：“向我展示沃特·范阿尔特 (Wout van Aert) 的球队历史和职业发展。”
专业分析：“Mathieu van der Poel 在纪念碑经典赛中取得了什么成绩？”
胜利分析：“列出乔纳斯·文格加德 (Jonas Vingegaard) 的所有世界巡回赛胜利。”
历史比较：“比较 Primož Roglič 和 Jonas Vingegaard 的大环赛成绩。”

种族研究

最近结果：“向我展示 2023 年巴黎-鲁贝赛的成绩。”
历史背景：“环弗兰德斯赛最年轻和最年长的冠军是谁？”
队伍分析：“获取 2023 年环法自行车赛的发车名单以及详细的队伍信息。”
比赛统计：“显示列日-巴斯通-列日赛的胜利表。谁赢得比赛的次数最多？”
赛段信息：“您能向我展示一下 2023 年环意自行车赛的赛段概况吗？”

体育新闻

“为自行车杂志文章创建 Remco Evenepoel 的详细资料。”
“根据塔德·波加查 (Tadej Pogačar) 和乔纳斯·文格加德 (Jonas Vingegaard) 等顶级竞争者的近期成绩，为即将到来的环法自行车赛撰写一篇预测。”
“根据汤姆·皮德科克的比赛成绩和团队历史分析他的职业生涯的发展。”

自行车教育

“使用有关纪念碑经典赛的历史和获胜者的数据来解释是什么让纪念碑经典赛如此特别。”
“创建一份关于大巡回赛及其在职业自行车运动中的意义的教育摘要。”
“使用数据中的例子来描述职业自行车手的典型职业发展。”

要求

Python 3.10 或更高版本
uv包管理器（推荐）
pyproject.toml中列出的依赖项，包括：
- 甲基氯丙烯
- beautifulsoup4
- lxml
- 熊猫
- 睡眠
- 以及其他用于网页抓取和数据处理的软件包

设置

克隆此存储库
创建并激活虚拟环境：
uv venv source .venv/bin/activate # On macOS/Linux # or .venv\Scripts\activate # On Windows
安装依赖项：
uv pip install -e .

FirstCycling API

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

MCP 工具

服务器通过模型上下文协议公开以下工具：

乘客信息

工具	描述
`get_rider_info`	获取骑手的基本个人信息，包括国籍、出生日期、体重、身高和当前队伍
`get_rider_best_results`	检索骑手职业生涯的最佳成绩，按重要性排序
`get_rider_grand_tour_results`	获取环法自行车赛、环意自行车赛、环西自行车赛等大满贯赛事的骑手成绩
`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`	获取骑手职业生涯胜利列表，并可选择世界巡回赛或 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 集成：

编辑 Claude for Desktop 配置文件，位于：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows： %APPDATA%\Claude\claude_desktop_config.json
将服务器添加到您的配置中：
{ "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } }
重启 Claude 桌面版

执照

麻省理工学院

FirstCycling MCP Server

Integrations