Formula One MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供一级方程式赛车数据。 此软件包公开了各种用于查询 F1 数据的工具，包括赛事日程、车手信息、遥测数据和比赛结果。

特性

• 赛事日程: 访问任何赛季的完整 F1 赛事日历
• 赛事信息: 关于特定大奖赛赛事的详细数据
• 分站结果: 来自比赛、排位赛、冲刺赛和练习赛的综合结果
• 车手信息: 访问特定分站的车手详细信息
• 性能分析: 使用单圈时间统计分析车手的表现
• 车手比较: 比较同一分站中多位车手的表现
• 遥测数据: 访问特定单圈的详细遥测数据
• 锦标赛积分榜: 查看任何赛季的车手和车队积分榜

安装

在一个 uv 管理的 python 项目中，通过以下方式添加到依赖项：

uv add f1-mcp-server

或者，对于使用 pip 作为依赖项的项目：

pip install f1-mcp-server

要在您的项目中运行服务器：

uv run f1-mcp-server

或者在隔离环境中全局运行它：

uvx 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 传输模式 (用于 Web 应用程序):

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

Python API

from f1_mcp_server import main

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

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

API 文档

服务器通过 MCP 公开以下工具：

工具名称	描述
get_event_schedule	获取特定赛季的一级方程式赛车日历
get_event_info	获取关于特定一级方程式大奖赛的详细信息
get_session_results	获取特定一级方程式分站的结果
get_driver_info	获取关于特定一级方程式车手的信息
analyze_driver_performance	分析车手在一级方程式分站中的表现
compare_drivers	比较多位一级方程式车手之间的表现
get_telemetry	获取特定一级方程式单圈的遥测数据
get_championship_standings	获取一级方程式锦标赛积分榜

有关底层数据的详细信息，请参阅 FastF1 文档：FastF1 Documentation

依赖项

• 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)

开发

设置开发环境

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"

代码质量

# 运行 linting
uv run ruff check .

# 运行格式检查
uv run ruff format --check .

# 运行安全检查
uv run bandit -r src/

贡献指南

1. Fork 仓库
2. 创建一个特性分支: git checkout -b feature-name
3. 提交您的更改: git commit -am 'Add some feature'
4. 推送到分支: git push origin feature-name
5. 提交一个 pull request

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

作者

• Machine-To-Machine

致谢

该项目利用了 FastF1，这是一个用于访问一级方程式数据的优秀 Python 包。 我们感谢其维护者和贡献者。

该项目受到 rakeshgangwar/f1-mcp-server 的启发，该项目是用 TypeScript 编写的。 f1_data.py 模块主要改编自他们的源代码。