F1 Data Server

F1 MCP Server

一个 Model Context Protocol (MCP) 服务，为 Claude Desktop 集成提供全面的 Formula 1 数据和分析。

功能

此服务提供 36+ 个工具，用于访问 F1 数据：

比赛数据

• 比赛结果和排名
• 冲刺赛结果
• 排位赛进程（Q1、Q2、Q3）
• 发车位与完赛排名对比
• 未完赛（DNF）名单及退赛原因

遥测与分析

• 车手间的速度曲线对比
• 换挡可视化
• 制动与油门分析
• 转速和引擎数据
• DRS 使用模式

计时与单圈

• 含分段时间的最快圈速数据
• 逐圈计时
• 被取消的圈速（赛道限制）
• 单圈稳定性统计
• 个人最快圈速

策略

• 轮胎配方分析
• 轮胎使用阶段明细
• 进站数据和最快进站记录
• 起步轮胎选择
• 策略对比

排名与历史

• 车手锦标赛排名
• 车队排名
• 历史比赛冠军
• 赛道纪录

实时数据

• 实时赛段状态
• 实时位置
• 实时单圈时间
• 实时遥测数据
• 当前天气状况

其他

• 车队无线电链接
• 比赛控制消息
• 赛道状态（旗帜、安全车）
• 天气数据
• 赛道信息

安装

前提条件

• Python 3.10 或更高版本
• Claude Desktop

设置

1. 克隆此代码库：

git clone https://github.com/drivenrajat/f1.git
cd f1

2. 创建虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 安装依赖项：

pip install -e .

配置 Claude Desktop

将此服务添加到 Claude Desktop MCP 配置中（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "f1": {
      "command": "python",
      "args": ["/path/to/f1/f1_server.py"]
    }
  }
}

如果使用 uv，也可以这样配置：

{
  "mcpServers": {
    "f1": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/f1", "python", "f1_server.py"]
    }
  }
}

使用方法

配置完成后，你可以向 Claude 提出如下问题：

• “显示 2024 年 F1 赛历”
• “获取 2024 年摩纳哥站的比赛结果”
• “对比 Verstappen 和 Norris 在 Silverstone 排位赛中的遥测数据”
• “Hamilton 在 Spa 站采用了什么轮胎策略？”
• “显示当前车手排名”
• “获取意大利大奖赛最快的进站记录”

数据来源

• FastF1：历史遥测数据、单圈时间和赛段数据
• Ergast API：锦标赛排名和历史比赛结果
• OpenF1 API：车队无线电录音

缓存

此服务会自动将 FastF1 数据缓存到 cache 目录，以提升重复查询的性能。

许可证

MIT 许可证 - 详情请参阅 LICENSE。

贡献

欢迎贡献！欢迎提交 Pull Request。