F1 Mcp Server

🏁 Formula 1 MCP 服务 🏎️

本项目为 Formula 1 数据定义了一个 MCP 服务，为车迷、分析师和开发者提供便捷的访问方式，获取种类丰富的 F1 统计数据和信息。该项目使用 Python 构建，并由 Gradio 框架驱动，提供易于使用的 Web 界面，便于通过 FastF1 库和官方 OpenF1 API 探索 F1 历史数据和近期数据。

视频演示（Claude Desktop）

架构

MCP 服务和客户端的架构概览。MCP 服务使用 Gradio 后端托管，可以在本地或远程服务上运行。

Gradio 主要功能

界面由多个 Gradio 选项卡组成，每个选项卡专门用于一种 F1 数据：

• 锦标赛积分榜： 查看 1950 年至今任意赛季的车手和车队最终积分榜。
• 赛事信息： 获取任意大奖赛的详细信息，包括赛程和赛道详情。
• 赛季日历： 显示指定年份的完整赛历。
• 赛道可视化： 生成并查看最快圈速的图表，展示速度、换挡情况和过弯 G 力。
• 分站赛成绩： 获取任意比赛环节（练习赛、排位赛或正赛）的详细成绩。
• 车手和车队信息： 查询车手和车队的背景信息与统计数据。
• OpenF1 API 工具： 面向开发者的高级工具包，可直接查询 OpenF1 API、构建自定义请求并查看原始 JSON 响应。

技术栈

• 后端： Python
• Web 框架： Gradio
• 数据来源：
  • 用于历史数据的 fastf1 Python 库。
  • 通过公开 API 提供实时和近期数据的 openf1。
• 主要库： pandas、matplotlib

MCP 服务

MCP 服务定义在 app.py 中。

MCP 客户端

MCP 客户端和 AI Agent 定义在 mcp_client.py 中，并通过服务器发送事件（SSE）传输方式与 MCP 服务交互。

MCP 配置文件

对于支持 SSE 传输的 MCP 客户端（Claude Desktop 请参见下文），可以使用以下配置：

{
  "mcpServers": {
    "gradio": {
      "url": "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse"
    }
  }
}

对于 Claude Desktop，也可以改用以下配置，但请确保已安装 Node.js：

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ]
    }
  }
}