MCP F1

🚀 F1 MCP 服務器

這是一個模型上下文協議（MCP）服務器，藉助 FastF1 Python 包提供一級方程式（F1）賽事數據。

✨ 主要特性

• 獲取任意 F1 賽季的比賽日程
• 獲取賽事各階段（練習賽、排位賽、正賽）的結果
• 獲取單圈成績和遙測數據
• 獲取車手和車隊的積分榜信息
• 獲取賽道信息

🚀 快速開始

前提條件

• Python 3.13
• uv 包管理器

1. 安裝 uv（若尚未安裝）

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 配置 F1 MCP 服務器

# 快速配置
./quick-start.sh

# 或手動配置
make install
# 或者：uv sync && uv pip install -e .

3. 啟動服務器

# MCP 模式（用於 MCP Inspector）
make mcp

# HTTP 模式（用於 OAuth 測試）  
make http

# 結合 MCP Inspector 使用
make inspector

📚 MCP Inspector 配置

MCP Inspector 是用於測試和調試 MCP 服務器的強大工具。以下是配置步驟：

1. 安裝 Node.js（若尚未安裝）

# 使用 Homebrew 在 macOS 上安裝
brew install node

# 或者從 https://nodejs.org/ 下載安裝

2. 安裝 MCP Inspector

# 使用 npm 全局安裝
npm install -g @modelcontextprotocol/inspector

# 驗證安裝
mcp-inspector --version

3. 結合 Inspector 啟動 F1 MCP 服務器

# 使用 make 命令（推薦）
make inspector

# 或者手動啟動
mcp-inspector uv run python -m f1_mcp_server.server

4. 使用 MCP Inspector

啟動後，Inspector 會：

1. 啟動一個 Web 界面（通常在 http://localhost:5173）
2. 自動連接到你的 F1 MCP 服務器
3. 提供一個交互式 UI 來測試所有可用工具

Inspector 中可用的 F1 工具：

• get_race_schedule - 瀏覽 F1 比賽日曆
• get_session_results - 查看比賽/排位賽結果
• get_driver_standings - 查看車手積分榜
• get_constructor_standings - 查看車隊積分榜
• get_lap_times - 進行詳細的單圈計時分析

5. Inspector 中的使用示例

在 MCP Inspector 中嘗試以下示例請求：

獲取 2024 年比賽日程：

{
  "year": 2024
}

獲取摩納哥大獎賽比賽結果：

{
  "year": 2024,
  "round_number": 8,
  "session": "R"
}

獲取維斯塔潘的單圈成績：

{
  "year": 2024,
  "round_number": 1,
  "session": "R",
  "driver": "VER"
}

解決 MCP Inspector 問題

Inspector 無法啟動：

# 檢查 Node.js 版本（需要 16 及以上）
node --version

# 重新安裝 Inspector
npm uninstall -g @modelcontextprotocol/inspector
npm install -g @modelcontextprotocol/inspector

服務器連接問題：

# 先直接測試服務器
make test-startup

# 檢查服務器在不使用 Inspector 的情況下是否能啟動
make mcp

端口衝突：

# Inspector 默認使用 5173 端口
# 終止佔用該端口的所有進程
lsof -ti:5173 | xargs kill -9

📚 結合 MCP Inspector 使用

MCP Inspector 提供了一個基於 Web 的界面，用於測試 F1 數據工具：

# 安裝 MCP Inspector（需要 Node.js）
npm install -g @modelcontextprotocol/inspector

# 結合 Inspector 啟動 F1 服務器
make inspector

# 或者手動啟動
mcp-inspector uv run python -m f1_mcp_server.server

Inspector 特性：

• 在 http://localhost:5173 提供交互式 Web UI
• 即時測試 F1 數據
• JSON 模式驗證
• 工具文檔瀏覽

📚 可用工具

• get_race_schedule：獲取特定賽季的比賽日程
• get_session_results：獲取特定賽事階段的結果
• get_driver_standings：獲取車手積分榜信息
• get_constructor_standings：獲取車隊積分榜信息
• get_lap_times：獲取特定賽事階段的單圈成績