🚀 一级方程式 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/
贡献指南
- 克隆仓库
git clone https://github.com/your-username/f1-mcp-server.git
cd f1-mcp-server
- 创建功能分支
git checkout -b feature-name
- 提交更改
git add .
git commit -m '添加新功能'
- 推送到远程仓库
git push origin feature-name
- 创建拉取请求
📄 许可证
本项目采用 MIT 许可证，具体内容请参阅 LICENSE 文件。
👨💻 作者
- Machine To Machine
🙏 致谢
该项目依赖于 FastF1，这是一个出色的 Python 库，用于访问一级方程式数据。我们对维护者和贡献者表示衷心的感谢。
该项目灵感来源于 rakeshgangwar/f1-mcp-server，该仓库使用 TypeScript 编写。f1_data.py 模块大部分内容基于其源代码改编。