JinDaGe - f1-mcp-server MCP Details

article

README

🚀 一级方程式 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 模块大部分内容基于其源代码改编。

f1-mcp-server