F1

🚀 F1 MCP 服务器

这是一个模型上下文协议（MCP）服务器，专为Claude桌面集成提供全面的一级方程式赛车（F1）数据和分析。

🚀 快速开始

在使用F1 MCP服务器之前，请确保你已经安装了Python 3.10或更高版本，以及Claude桌面应用程序。

安装步骤

1. 克隆此仓库：

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

2. 创建一个虚拟环境：

python -m venv venv
source venv/bin/activate  # 在Windows上使用：venv\Scripts\activate

3. 安装依赖项：

pip install -e .

配置Claude桌面

将此服务器添加到你的Claude桌面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"]
    }
  }
}

✨ 主要特性

此服务器提供36种以上的工具，用于访问F1数据，涵盖以下多个方面：

比赛数据

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

遥测与分析

• 车手之间的速度轨迹对比
• 换挡可视化
• 刹车和油门分析
• 转速和发动机数据
• DRS使用模式

计时与圈速

• 最快圈速及各赛段时间
• 逐圈计时
• 被删除的圈速（赛道限制违规）
• 圈速一致性统计
• 个人最佳圈速

策略分析

• 轮胎配方分析
• 赛段分析
• 进站数据和最快进站
• 起步轮胎选择
• 策略对比

排名与历史

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

实时数据

• 实时比赛状态
• 实时位置
• 实时圈速
• 实时遥测
• 当前天气状况

其他

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

💻 使用示例

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

• “显示2024年F1赛程表”
• “获取2024年摩纳哥站的比赛结果”
• “比较银石站排位赛中维斯塔潘和诺里斯的遥测数据”
• “汉密尔顿在斯帕站的轮胎策略是什么？”
• “显示当前车手排名”
• “获取意大利大奖赛的最快进站数据”

📚 详细文档

数据来源

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

缓存机制

服务器会自动将FastF1数据缓存在cache目录中，以提高重复查询的性能。

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

🔗 贡献

欢迎大家贡献代码！请随时提交拉取请求。