一级方程式 MCP 服务器

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

特征

• 赛事日程：查看任意赛季的完整 F1 赛事日程

• 赛事信息：有关特定大奖赛赛事的详细数据

• 比赛结果：比赛、排位赛、短跑和练习赛的综合结果

• 驾驶员信息：访问特定会话的驾驶员详细信息

• 性能分析：通过单圈时间统计数据分析驾驶员的表现

• 车手对比：比较同一时段内多名车手的表现

• 遥测数据：获取特定圈数的详细遥测数据

• 锦标赛积分榜：查看任意赛季的车手和车队积分榜

Related MCP server: Formula1 MCP Server

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 f1-mcp-server：

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

手动安装

在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

# Run the server with default settings
main()

# Or with SSE transport settings
main(port=9000, transport="sse")

API 文档

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

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

依赖项

• anyio（>=4.9.0）

• 点击（>=8.1.8）

• fastf1（>=3.5.3）

• mcp（>=1.6.0）

• numpy（>=2.2.4）

• 熊猫（>=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]"

代码质量

# Run linting
uv run ruff check .

# Run formatting check
uv run ruff format --check .

# Run security checks
uv run bandit -r src/

贡献指南

1. 分叉存储库

2. 创建功能分支： git checkout -b feature-name

3. 提交您的更改： git commit -am 'Add some feature'

4. 推送到分支： git push origin feature-name

5. 提交拉取请求

执照

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

作者

• 机器对机器

致谢

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

该项目f1_data.py灵感来源于用 TypeScript 编写的rakeshgangwar/f1-mcp-server。f1_data.py模块大部分改编自其源代码。