Formula One MCP Server

Formula One MCP Server

site icon
2025.05.09 0
Python赛车数据服务体育数据分析娱乐功能
Formula One MCP Server 是一个提供一级方程式赛车数据的模型上下文协议(MCP)服务器。该服务器通过多种工具查询F1数据,包括赛事日程、车手信息、遥测数据和比赛结果等。
View on GitHub

Overview

基本能力

产品定位

Formula One MCP Server 是一个专门用于提供一级方程式赛车相关数据的服务,旨在为开发者和数据分析师提供丰富的F1赛事数据支持。

核心功能

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

适用场景

  • F1赛事数据分析
  • 赛车性能比较
  • 车手表现追踪
  • F1相关应用开发

工具列表

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

常见问题解答

  • 数据来源:基于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)

安装教程

通过Smithery安装

npx -y @smithery/cli install @Machine-To-Machine/f1-mcp-server --client claude

手动安装

使用uv管理:

uv add f1-mcp-server

使用pip管理:

pip install f1-mcp-server

从源代码安装:

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

调试方式

标准I/O模式

uvx run f1-mcp-server

SSE传输模式

uvx f1-mcp-server --transport sse --port 8000

Python API

from f1_mcp_server import main

# 使用默认设置运行服务器
main()

# 或使用SSE传输设置
main(port=9000, transport="sse")

许可证

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