Formula One MCP Server

Formula One MCP Server

site icon
2025.04.17 0
Python赛车数据赛事分析娱乐功能
f1-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务,专门用于提供 Formula One(一级方程式赛车)的相关数据。该服务通过多种工具查询 F1 赛事数据,包括赛事日程、车手信息、遥测数据和比赛结果等。
View on GitHub

Overview

基本能力

产品定位

f1-mcp-server 是一个专门用于提供 Formula One 赛事数据的服务,旨在为开发者、数据分析师和赛车爱好者提供便捷的 F1 数据访问和分析工具。

核心功能

  • 赛事日程:获取任意赛季的 F1 赛事日历。
  • 赛事信息:获取特定大奖赛的详细信息。
  • 比赛结果:获取比赛、排位赛、冲刺赛和练习赛的详细结果。
  • 车手信息:获取特定车手的详细信息。
  • 性能分析:分析车手在特定比赛中的表现,包括圈速统计。
  • 车手对比:比较多名车手在同一比赛中的表现。
  • 遥测数据:获取特定圈数的遥测数据。
  • 锦标赛排名:获取任意赛季的车手和车队排名。

适用场景

  • 赛车数据分析:用于分析车手表现、比赛策略等。
  • 赛事应用开发:为赛车相关的应用提供数据支持。
  • 赛车爱好者:获取最新的 F1 赛事信息和数据。

工具列表

工具名称 描述
get_event_schedule 获取特定赛季的 F1 赛事日历
get_event_info 获取特定大奖赛的详细信息
get_session_results 获取特定比赛的结果
get_driver_info 获取特定车手的信息
analyze_driver_performance 分析车手在特定比赛中的表现
compare_drivers 比较多名车手在同一比赛中的表现
get_telemetry 获取特定圈数的遥测数据
get_championship_standings 获取锦标赛排名

常见问题解答

  • 如何安装?:可以通过 uvpip 安装,具体命令见安装教程。
  • 如何运行?:可以通过命令行或 Python API 运行,支持标准 I/O 模式和 SSE 传输模式。
  • 数据来源?:数据来源于 FastF1 包,详细信息可参考其文档。

使用教程

使用依赖

安装前需确保已安装 Python 和相关依赖包,具体依赖如下: - anyio (>=4.9.0) - click (>=8.1.8) - fastf1 (>=3.5.3) - mcp (>=1.6.0) - numpy (>=2.2.4) - pandas (>=2.2.3) - uvicorn (>=0.34.0)

安装教程

  1. 使用 uv 安装:
uv add f1-mcp-server
  1. 使用 pip 安装:
pip install f1-mcp-server
  1. 从源码安装:
git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
pip install -e .

调试方式

  1. 运行服务器(标准 I/O 模式):
uvx run f1-mcp-server
  1. 运行服务器(SSE 传输模式):
uvx f1-mcp-server --transport sse --port 8000
  1. 使用 Python API 运行:
from f1_mcp_server import main
main()
# 或使用 SSE 传输模式
main(port=9000, transport="sse")

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。