F1 MCP Server

🚀 一级方程式 MCP 服务器

一级方程式 MCP 服务器是一个提供一级方程式赛车数据的模型上下文协议 (MCP) 服务器。此项目提供了多种工具，可用于查询赛事日历、车手信息、遥测数据和比赛结果，为一级方程式赛车爱好者和开发者提供了便捷的数据获取途径。

🚀 快速开始

命令行使用

# 启动服务器
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())

✨ 主要特性

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

📦 安装指南

通过 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 .

📚 详细文档

项目结构

• 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 模块大部分内容基于其源代码改编。