FirstCycling MCP Server

FirstCycling MCP Server

这是一个提供来自FirstCycling的专业自行车数据的模型上下文协议(MCP)服务器。它允许您获取有关专业自行车手、比赛结果等信息。

概述

FirstCycling MCP 服务器提供专业自行车赛事数据的访问,包括骑手信息、比赛结果和历史数据等。

安装与设置

要求

  • Python 3.10+
  • uv 包管理器(推荐)

步骤

  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

与 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"]
    }
  }
}

主要功能

骑手信息

  • 基本信息、最佳成绩、大环赛和经典赛成绩
  • 车队历史、排名演变、完整参赛历史
  • 胜利记录和详细比赛数据

比赛数据

  • 比赛结果、概览和历史数据
  • 赛段概况、起跑名单、获胜记录
  • 年度数据和统计分析

搜索工具

  • search_rider: 按姓名搜索骑手
  • search_race: 按名称搜索比赛

案例应用

  • 骑手分析: "塔代伊·波加查在历年环法的表现如何?"
  • 比赛研究: "显示2023年巴黎-鲁贝的比赛结果"
  • 体育新闻: "为自行车杂志文章创建雷姆科·埃文普尔的详细档案"
  • 自行车教育: "解释古典赛的历史意义"

更多详细信息请参考完整文档。该服务器基于 MIT 许可证分发。