FirstCycling MCP Server

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
  • 熊猫
  • 睡眠
  • 以及其他用于网页抓取和数据处理的软件包

设置

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 工具

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

乘客信息

赛事信息

搜索工具

用法

开发模式

您可以通过运行以下命令使用 MCP Inspector 测试服务器：

这将启动服务器并在您的浏览器中打开 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 桌面版

执照

麻省理工学院