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文件。

🔗 貢獻

歡迎大家貢獻代碼！請隨時提交拉取請求。