金大哥 - f1 MCP 详情

article

README

🚀 F1 MCP 服务器

这是一个模型上下文协议（MCP）服务器，专为Claude桌面集成提供全面的一级方程式赛车（F1）数据和分析。

🚀 快速开始

在使用F1 MCP服务器之前，请确保你已经安装了Python 3.10或更高版本，以及Claude桌面应用程序。

安装步骤

克隆此仓库：

git clone https://github.com/drivenrajat/f1.git
cd f1

创建一个虚拟环境：

python -m venv venv
source venv/bin/activate  # 在Windows上使用：venv\Scripts\activate

安装依赖项：

pip install -e .

配置Claude桌面

将此服务器添加到你的Claude桌面MCP配置中（在macOS上的路径为~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "f1": {
      "command": "python",
      "args": ["/path/to/f1/f1_server.py"]
    }
  }
}

或者，如果你使用的是uv：

{
  "mcpServers": {
    "f1": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/f1", "python", "f1_server.py"]
    }
  }
}

✨ 主要特性

此服务器提供36种以上的工具，用于访问F1数据，涵盖以下多个方面：

比赛数据

比赛结果和排名
冲刺赛结果
排位赛进程（Q1、Q2、Q3）
发车顺位与完赛顺位对比
退赛名单及退赛原因

遥测与分析

车手之间的速度轨迹对比
换挡可视化
刹车和油门分析
转速和发动机数据
DRS使用模式

计时与圈速

最快圈速及各赛段时间
逐圈计时
被删除的圈速（赛道限制违规）
圈速一致性统计
个人最佳圈速

策略分析

轮胎配方分析
赛段分析
进站数据和最快进站
起步轮胎选择
策略对比

排名与历史

车手锦标赛排名
车队排名
历史比赛冠军
赛道记录

实时数据

实时比赛状态
实时位置
实时圈速
实时遥测
当前天气状况

其他

车队无线电链接
赛事控制消息
赛道状态（旗帜、安全车）
天气数据
赛道信息

💻 使用示例

配置完成后，你可以向Claude提出以下问题：

“显示2024年F1赛程表”
“获取2024年摩纳哥站的比赛结果”
“比较银石站排位赛中维斯塔潘和诺里斯的遥测数据”
“汉密尔顿在斯帕站的轮胎策略是什么？”
“显示当前车手排名”
“获取意大利大奖赛的最快进站数据”

📚 详细文档

数据来源

FastF1：历史遥测、圈速和比赛数据
Ergast API：锦标赛排名和历史结果
OpenF1 API：车队无线电录音

缓存机制

服务器会自动将FastF1数据缓存在cache目录中，以提高重复查询的性能。

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

🔗 贡献

欢迎大家贡献代码！请随时提交拉取请求。

f1