一级方程式 MCP 服务器

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

功能

• 赛事日历: 获取任何赛季的一级方程式比赛日历
• 赛事信息: 获得特定大奖赛的详细数据
• 会话结果: 查看比赛、排位赛、冲刺赛和练习赛的全面结果
• 车手信息: 查询特定会话中车手的详细信息
• 性能分析: 分析车手在特定会话中的表现，包括圈速统计
• 车手对比: 比较不同车手在比赛中的表现
• 遥测数据: 获取实时赛道数据和车辆状态

安装

通过 Smithery

uv get package f1-mcp-server

手动安装

使用 pip 安装

pip install f1-mcp-server

克隆仓库并安装

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

快速开始

命令行使用

# 启动服务器
python -m f1_mcp_server.start

# 访问控制台
python -m f1_mcp_server.console

Python API 示例

from f1_mcp_server import F1MCPClient

client = F1MCPClient()
print(client.get_circuit())

项目结构

• f1_data.py: 包含所有与一级方程式数据交互的函数。
• server.py: 实现 MCP 服务器的核心逻辑。
• config.py: 存储默认配置和环境变量。

依赖项

flask==2.0.3
requests==2.26.0

开发环境设置

创建虚拟环境并安装依赖

uv venv
source .venv/bin/activate  # Windows 用户请使用 .venv\Scripts\activate
pip install -r requirements.txt

质量控制

格式检查

black .
flake8 .

代码审查

bandit run src/

贡献指南

1. 克隆仓库

   git clone https://github.com/your-username/f1-mcp-server.git
   cd f1-mcp-server
   

2. 创建功能分支

   git checkout -b feature-name
   

3. 提交更改

   git add .
   git commit -m '添加新功能'
   

4. 推送到远程仓库

   git push origin feature-name
   

5. 创建拉取请求

许可证

本项目采用 MIT 许可证，具体内容请参阅 LICENSE 文件。

作者

• Machine To Machine

致谢

该项目依赖于 FastF1，这是一个出色的 Python 库，用于访问一级方程式数据。我们对维护者和贡献者表示衷心的感谢。

该项目灵感来源于 rakeshgangwar/f1-mcp-server，该仓库使用 TypeScript 编写。f1_data.py 模块大部分内容基于其源代码改编。