金大哥 - mcp-f1 MCP 详情

article

README

🚀 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 会：

启动一个 Web 界面（通常在 http://localhost:5173）
自动连接到你的 F1 MCP 服务器
提供一个交互式 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：获取特定赛事阶段的单圈成绩

mcp-f1