Formula One MCP Server

一级方程式 MCP 服务

此模型上下文协议（MCP）服务使用 FastF1 Python 库提供对一级方程式数据和统计信息的访问。通过简洁的 MCP 接口，你可以访问赛历、赛事信息、分站赛结果、车手数据、单圈时间、遥测数据以及锦标赛积分榜。

功能

• 获取指定赛季的一级方程式赛历
• 获取大奖赛赛事的详细信息
• 获取分站赛结果（正赛、排位赛、练习赛）
• 访问车手信息和统计数据
• 使用单圈时间和遥测数据分析车手表现
• 比较多位车手的表现
• 获取车手和车队的锦标赛积分榜

先决条件

• Node.js 18 或更高版本
• Python 3.8 或更高版本
• FastF1 库

安装

1. 安装 Python 依赖项

pip install fastf1 pandas numpy

2. 安装 Node.js 依赖项

cd f1-mcp-server
npm install

3. 构建 TypeScript 代码

npm run build

4. 添加到 MCP 设置

将以下内容添加到 Cline MCP 设置文件（~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": ["/Users/rakeshgangwar/Documents/Cline/MCP/f1-mcp-server/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

1. get_event_schedule

获取指定赛季的一级方程式赛历。

参数：

• year（number）：赛季年份（例如，2023）

2. get_event_info

获取指定一级方程式大奖赛的详细信息。

参数：

• year（number）：赛季年份（例如，2023）
• identifier（string）：赛事名称或分站编号（例如，"Monaco" 或 "7"）

3. get_session_results

获取指定一级方程式分站赛的结果。

参数：

• year（number）：赛季年份（例如，2023）
• event_identifier（string）：赛事名称或分站编号（例如，"Monaco" 或 "7"）
• session_name（string）：分站赛名称（例如，"Race"、"Qualifying"、"Sprint"、"FP1"、"FP2"、"FP3"）

4. get_driver_info

获取指定一级方程式车手的信息。

参数：

• year（number）：赛季年份（例如，2023）
• event_identifier（string）：赛事名称或分站编号（例如，"Monaco" 或 "7"）
• session_name（string）：分站赛名称（例如，"Race"、"Qualifying"、"Sprint"、"FP1"、"FP2"、"FP3"）
• driver_identifier（string）：车手标识符（号码、代码或姓名；例如，"44"、"HAM"、"Hamilton"）

5. analyze_driver_performance

分析车手在一级方程式某分站赛中的表现。

参数：

• year（number）：赛季年份（例如，2023）
• event_identifier（string）：赛事名称或分站编号（例如，"Monaco" 或 "7"）
• session_name（string）：分站赛名称（例如，"Race"、"Qualifying"、"Sprint"、"FP1"、"FP2"、"FP3"）
• driver_identifier（string）：车手标识符（号码、代码或姓名；例如，"44"、"HAM"、"Hamilton"）

6. compare_drivers

比较多位一级方程式车手的表现。

参数：

• year（number）：赛季年份（例如，2023）
• event_identifier（string）：赛事名称或分站编号（例如，"Monaco" 或 "7"）
• session_name（string）：分站赛名称（例如，"Race"、"Qualifying"、"Sprint"、"FP1"、"FP2"、"FP3"）
• drivers（string）：以逗号分隔的车手代码列表（例如，"HAM,VER,LEC"）

7. get_telemetry

获取指定一级方程式单圈的遥测数据。

参数：

• year（number）：赛季年份（例如，2023）
• event_identifier（string）：赛事名称或分站编号（例如，"Monaco" 或 "7"）
• session_name（string）：分站赛名称（例如，"Race"、"Qualifying"、"Sprint"、"FP1"、"FP2"、"FP3"）
• driver_identifier（string）：车手标识符（号码、代码或姓名；例如，"44"、"HAM"、"Hamilton"）
• lap_number（number，可选）：单圈编号（如果未提供，则获取最快单圈）

8. get_championship_standings

获取一级方程式锦标赛积分榜。

参数：

• year（number）：赛季年份（例如，2023）
• round_num（number，可选）：分站编号（如果未提供，则获取最新积分榜）

示例用法

将服务添加到 MCP 设置并运行后，你可以使用这些工具，通过 Cline 访问一级方程式数据。

示例查询：

• “显示 2023 年一级方程式赛历”
• “获取 2022 年摩纳哥大奖赛的成绩”
• “比较 Hamilton 和 Verstappen 在 2021 年英国大奖赛中的表现”
• “显示 Leclerc 在 2023 年意大利大奖赛排位赛中最快一圈的遥测数据”
• “当前 F1 锦标赛积分榜是什么？”

数据源

此服务使用 FastF1 Python 库，该库可访问官方一级方程式计时数据、赛车遥测数据和分站赛成绩。

许可证

MIT