FirstCycling MCP 服务器

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

功能

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

• 查找关于专业自行车手的信息
• 检索比赛结果和详情
• 探索历史比赛数据
• 分析车手表现和职业发展
• 访问关于自行车队和比赛的信息

真实世界用例

通过此 MCP 服务器，您可以使用 Claude 来：

车手分析

• 表现追踪: "Tadej Pogačar 多年来在环法自行车赛中的表现如何？"
• 职业发展: "展示 Wout van Aert 的车队历史和职业发展。"
• 专长分析: "Mathieu van der Poel 在 Monument 古典赛中的成绩如何？"
• 胜利分析: "列出 Jonas Vingegaard 的所有 WorldTour 胜利。"
• 历史比较: "比较 Primož Roglič 和 Jonas Vingegaard 的 Grand Tour 成绩。"

比赛研究

• 近期结果: "展示 2023 年巴黎-鲁贝的比赛结果。"
• 历史背景: "谁是环弗兰德斯赛最年轻和最年长的获胜者？"
• 车队分析: "获取 2023 年环法自行车赛的出发名单，其中包含详细的车队信息。"
• 比赛统计: "展示列日-巴斯托涅-列日的胜利榜。谁赢得的次数最多？"
• 赛段信息: "你能展示 2023 年环意大利自行车赛的赛段剖面图吗？"

体育新闻

• "为自行车杂志文章创建一个关于 Remco Evenepoel 的详细简介。"
• "根据 Tadej Pogačar 和 Jonas Vingegaard 等顶级竞争者的近期成绩，撰写即将到来的环法自行车赛的预览。"
• "根据 Tom Pidcock 的比赛结果和车队历史，分析他的职业生涯演变。"

自行车教育

• "使用关于 Monument 古典赛的历史和获胜者的数据，解释是什么让它们如此特别。"
• "创建一个关于 Grand Tours 及其在专业自行车运动中的重要性的教育总结。"
• "使用数据中的示例，描述专业自行车手的典型职业发展。"

要求

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

设置

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

   uv venv
   source .venv/bin/activate  # 在 macOS/Linux 上
   # 或
   .venv\Scripts\activate  # 在 Windows 上
   

3. 安装依赖项：

   uv pip install -e .
   

FirstCycling API

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

MCP 工具

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

车手信息

工具	描述
get_rider_info	获取关于车手的基本传记信息，包括国籍、出生日期、体重、身高和当前车队
get_rider_best_results	检索车手职业生涯中最好的成绩，按重要性排序
get_rider_grand_tour_results	获取车手在 Grand Tours（环法自行车赛、环意大利自行车赛、环西班牙自行车赛）中的成绩
get_rider_monument_results	检索车手在自行车 Monument 古典赛中的成绩
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