FirstCycling MCP Server

基本能力

产品定位

FirstCycling MCP Server 是一个专注于提供职业自行车运动数据的服务，旨在为体育分析师、记者、教育工作者和自行车爱好者提供全面的数据支持。

核心功能

• 获取职业自行车手的基本信息和职业发展历史
• 检索比赛结果和详情
• 探索历史比赛数据
• 分析自行车手的表现和职业发展
• 访问自行车队和比赛的信息

适用场景

• 自行车手分析：跟踪自行车手的表现、职业发展和专项能力
• 比赛研究：获取比赛结果、历史数据和统计信息
• 体育新闻报道：为杂志文章和比赛预览提供数据支持
• 自行车教育：解释比赛的重要性和自行车手的职业发展

工具列表

自行车手信息工具

• get_rider_info：获取自行车手的基本信息
• get_rider_best_results：检索自行车手的最佳比赛结果
• get_rider_grand_tour_results：获取自行车手在大环赛中的结果
• get_rider_monument_results：获取自行车手在经典赛中的结果
• get_rider_team_and_ranking：获取自行车手的车队历史和排名演变
• get_rider_race_history：检索自行车手的完整比赛历史
• get_rider_one_day_races：获取自行车手在单日赛中的结果
• get_rider_stage_races：获取自行车手在多日赛中的结果
• get_rider_teams：检索自行车手的完整车队历史
• get_rider_victories：获取自行车手的职业生涯胜利列表

比赛信息工具

• get_race_results：检索特定比赛的结果
• 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：按名称搜索自行车手
• search_race：按名称搜索比赛

使用教程

使用依赖

• 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 .

调试方式

开发模式

可以使用 MCP Inspector 测试服务器，运行：

uv run mcp dev firstcycling.py

这将启动服务器并在浏览器中打开 MCP Inspector，允许您测试可用的工具。

与 Claude for Desktop 集成

1. 编辑 Claude for Desktop 的配置文件
2. 将服务器添加到配置中
3. 重启 Claude for Desktop

常见问题解答

• 如何获取自行车手的基本信息？ 使用 get_rider_info 工具。
• 如何检索比赛结果？ 使用 get_race_results 工具。
• 如何搜索自行车手？ 使用 search_rider 工具。
• 如何搜索比赛？ 使用 search_race 工具。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。