Open Formula 1 Mcp Server

Open-F1-MCP-Server

此项目实现了 Open Formula 1 的 MCP 服务。

如需了解更多详细信息，请查看 Open F1 MCP 服务的实现

我是一名高中生，想知道大家是否喜欢和／或使用我的项目。如果你喜欢或使用此 MCP 服务，请在 GitHub 上点个星并分享给朋友，谢谢！！

Arya Akman

什么是 Open Formula 1

Open Formula 1 是一个开源 API，提供实时和历史 Formula 1 数据。

该 API 提供了丰富的信息，包括单圈用时、赛车遥测数据、无线电通信等。无论你是想创建交互式仪表板、深入分析比赛，还是开发能在你最喜欢的车手取得领先时亮起的联网设备，OpenF1 都能让这一切成为可能。

工具（截至 v1.2）

get_sessions：

获取 F1 比赛赛段。可按年份、国家、赛道、赛段类型等筛选。返回赛段详情，包括 session_key、日期、地点和类型。

参数	        描述
year		        按年份筛选（例如，2023、2024）。
country_name	    按国家名称筛选（例如，'Monaco'、'Italy'）。
circuit_short_name	按赛道简称筛选（例如，'Monza'、'Monaco'）。
session_name    	按赛段名称筛选（例如，'Race'、'Qualifying'、'Sprint'）。
session_key	    	按唯一的 session_key 获取指定赛段。
date_start	    	按开始日期筛选（ISO 格式：YYYY-MM-DD）。支持 >= 和 <= 等筛选条件。
其他筛选条件		session_type、location、country_code、meeting_key、gmt_offset

get_drivers：

获取车手信息。可获取所有当前车手，也可按 session_key 筛选以获取参加特定赛段的车手。返回车手详情，包括姓名、号码、车队、国家和头像 URL。

参数	    	描述
session_key	    	可选。按 session_key 筛选车手，以获取特定赛段的参赛车手。
driver_number	   	可选。按车手号码筛选（例如，1、44、16）。
team_name        	可选。按车队名称筛选（例如，'Red Bull Racing'、'Ferrari'）。

get_laps：

获取特定赛段、车手和圈数的圈速数据。返回详细的单圈信息，包括圈速、各计时区段用时、持续时间和位置。

参数	    	描述
session_key	    	要获得有效结果，必须提供。按唯一的赛段键筛选。
driver_number	   	可选。按车手号码筛选（例如，1、44、16）。
lap_number	    	可选。按指定圈数筛选。

get_pit_stops：

获取特定赛段的进站数据。返回详细的进站信息，包括持续时间、圈数和时间。

参数	    	描述
session_key	        要获得有效结果，必须提供。按唯一的赛段键筛选。
driver_number		可选。按车手号码筛选（例如，1、44、16）。
pit_duration		可选。进站时长的上限，单位为秒（例如，30.0 表示进站时间少于 30 秒）。

get_overtakes：

获取显示车手之间位置变化的超车数据。超车是指一名车手（超车车手）与另一名车手（被超车车手）交换位置。返回详细信息，包括涉及的车手、圈数和事件发生时间。

参数	                描述
session_key	    	        要获得有效结果，必须提供。按唯一的赛段键筛选。
overtaking_driver_number    可选。按实施超车的车手号码筛选（例如，1、44）。
overtaken_driver_number		可选。按被超车的车手号码筛选（例如，16、63）。

安装说明：

1. 安装依赖项：

bashpip install mcp httpx

## 2. 添加/更新 Claude 桌面应用配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "Open-F1": {
      "command": "python",
      "args": ["/path/to/OpenF1MCPServer.py"]
    }
  }
}

3. 重启 Claude 桌面应用并验证安装

前往 Claude Desktop -> 文件 -> 设置 -> 开发者

在屏幕右侧的“本地 MCP 服务”下，确认：

• 显示“Open-F1”
• 状态为“运行中”（以蓝色背景突出显示）

使用示例

以下提示词示例可帮助你了解如何使用此 MCP 服务

• 与赛程（比赛）相关的使用示例

  • “显示 2024 年的所有 F1 赛程”

  • “获取 2023 年摩纳哥大奖赛的赛程详情”

• 与车手相关的使用示例

  • “谁参加了赛程 9158？”（使用 session_key）

  • “显示 2024 年蒙扎大奖赛中所有法拉利车手”

• 与单圈信息相关的使用示例

  • “获取 2024 年摩纳哥大奖赛中所有车手第 10 圈的数据”

  • “马克斯·维斯塔潘在上一场比赛中的最快单圈成绩是多少？”

  • “比较赛程 9158 中车手 1 和 44 第 1 圈的分段用时”

• 与进站相关的使用示例

  • “显示 2025 年新加坡大奖赛的所有进站记录”

  • “获取赛程 9158 中车手 1 的进站记录”

  • “找出上一场比赛中所有用时少于 25 秒的进站记录”

  • “赛程 Monaco 2025 race 中哪位车手的进站速度最快？”

  • “比较红牛和法拉利车手的进站用时”

  • “显示 2025 年新加坡大奖赛中所有用时超过 30 秒的进站记录”

• 与超车相关的使用示例

  • “显示 2024 年摩纳哥大奖赛中的所有超车记录”

  • “赛程 9158 中，车手 1 超过其他车手多少次？”

  • “上一场比赛中谁超过了车手 44？”

  • “显示所有涉及车手 16 的超车记录”

  • “赛程 9158 中哪一圈的超车次数最多？”

  • “显示车手 1 和 16 之间的所有攻防”（可同时使用两个参数）

该服务会处理对 OpenF1 的 API 调用，并返回格式化数据，供 Claude 解读并呈现给你