一级方程式 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, optional): 圈数（如果未提供，则获取最快圈速）

8. get_championship_standings

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

参数：

• year (number): 赛季年份 (例如，2023)
• round_num (number, optional): 回合数（如果未提供，则获取最新积分榜）

使用示例

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

示例查询：

• "Show me the 2023 Formula One race calendar" (显示 2023 年一级方程式比赛日历)
• "Get the results from the 2022 Monaco Grand Prix" (获取 2022 年摩纳哥大奖赛的结果)
• "Compare Hamilton and Verstappen's performance in the 2021 British Grand Prix" (比较汉密尔顿和维斯塔潘在 2021 年英国大奖赛中的表现)
• "Show me the telemetry data from Leclerc's fastest lap in the 2023 Italian Grand Prix qualifying" (显示勒克莱尔在 2023 年意大利大奖赛排位赛中最快圈速的遥测数据)
• "What are the current F1 championship standings?" (当前的 F1 锦标赛积分榜是什么？)

数据来源

此服务器使用 FastF1 Python 库，该库提供对官方一级方程式计时数据、赛车遥测数据和比赛结果的访问。

许可证

MIT