F1 MCP Server

🚀 一級方程式 MCP 服務器

一級方程式 MCP 服務器是一個提供一級方程式賽車數據的模型上下文協議 (MCP) 服務器。此項目提供了多種工具，可用於查詢賽事日曆、車手信息、遙測數據和比賽結果，為一級方程式賽車愛好者和開發者提供了便捷的數據獲取途徑。

🚀 快速開始

命令行使用

# 啟動服務器
python -m f1_mcp_server.start

# 訪問控制檯
python -m f1_mcp_server.console

Python API 示例

from f1_mcp_server import F1MCPClient

client = F1MCPClient()
print(client.get_circuit())

✨ 主要特性

• 賽事日曆：可獲取任何賽季的一級方程式比賽日曆。
• 賽事信息：能獲得特定大獎賽的詳細數據。
• 會話結果：可查看比賽、排位賽、衝刺賽和練習賽的全面結果。
• 車手信息：支持查詢特定會話中車手的詳細信息。
• 性能分析：可分析車手在特定會話中的表現，包括圈速統計。
• 車手對比：能比較不同車手在比賽中的表現。
• 遙測數據：可獲取即時賽道數據和車輛狀態。

📦 安裝指南

通過 Smithery

uv get package f1-mcp-server

手動安裝

使用 pip 安裝

pip install f1-mcp-server

克隆倉庫並安裝

git clone https://github.com/your-username/f1-mcp-server.git
cd f1-mcp-server
pip install -e .

📚 詳細文檔

項目結構

• f1_data.py：包含所有與一級方程式數據交互的函數。
• server.py：實現 MCP 服務器的核心邏輯。
• config.py：存儲默認配置和環境變量。

依賴項

flask==2.0.3
requests==2.26.0

開發環境設置

創建虛擬環境並安裝依賴

uv venv
source .venv/bin/activate  # Windows 用戶請使用 .venv\Scripts\activate
pip install -r requirements.txt

質量控制

格式檢查

black .
flake8 .

代碼審查

bandit run src/

貢獻指南

1. 克隆倉庫

   git clone https://github.com/your-username/f1-mcp-server.git
   cd f1-mcp-server
   

2. 創建功能分支

   git checkout -b feature-name
   

3. 提交更改

   git add .
   git commit -m '添加新功能'
   

4. 推送到遠程倉庫

   git push origin feature-name
   

5. 創建拉取請求

📄 許可證

本項目採用 MIT 許可證，具體內容請參閱 LICENSE 文件。

👨‍💻 作者

• Machine To Machine

🙏 致謝

該項目依賴於 FastF1，這是一個出色的 Python 庫，用於訪問一級方程式數據。我們對維護者和貢獻者表示衷心的感謝。

該項目靈感來源於 rakeshgangwar/f1-mcp-server，該倉庫使用 TypeScript 編寫。f1_data.py 模塊大部分內容基於其源代碼改編。