The Formula1 MCP Server ! 🏎️💨

The Formula1 MCP Server ! 🏎️💨

site icon
2025.04.15 10
TypeScriptF1 数据服务赛车数据娱乐功能
Formula1-mcp 是一个基于 TypeScript 的 MCP 服务器,专注于提供实时和历史 F1 赛车数据。通过 Model Context Protocol,用户可以获取包括实时遥测数据、历史比赛信息、车手和车队排名、天气数据以及赛道信息等丰富的 F1 相关资源。
View on GitHub

Overview

基本能力

产品定位

Formula1-mcp 是一个专注于 F1 赛车数据的 MCP 服务器,旨在为开发者和 F1 爱好者提供实时和历史赛车数据的访问能力。

核心功能

  • 实时 F1 比赛数据(如实时计时数据、当前比赛状态)
  • 历史比赛信息(如比赛结果、排位赛结果)
  • 车手和车队排名数据
  • 天气数据
  • 赛道信息
  • 详细的赛车遥测数据
  • 车队无线电通讯
  • 比赛控制消息

适用场景

  • F1 数据分析和可视化应用
  • F1 粉丝网站和社区
  • 赛车游戏和模拟器
  • 体育新闻报道
  • 赛车历史研究

工具列表

  1. getLiveTimingData - 获取当前赛段的实时计时数据
  2. getCurrentSessionStatus - 获取当前赛段状态信息
  3. getDriverInfo - 获取特定车手信息
  4. getHistoricalSessions - 查找历史赛事的赛段密钥
  5. getHistoricRaceResults - 获取特定历史比赛结果
  6. getDriverStandings - 获取车手锦标赛排名
  7. getConstructorStandings - 获取车队锦标赛排名
  8. getLapTimes - 获取特定车手的圈速
  9. getWeatherData - 获取赛段天气数据
  10. getCarData - 获取详细的赛车遥测数据
  11. getPitStopData - 获取进站信息
  12. getTeamRadio - 获取车队无线电通讯
  13. getRaceControlMessages - 获取比赛控制消息
  14. getRaceCalendar - 获取 F1 比赛日历
  15. getCircuitInfo - 获取详细赛道信息
  16. getSeasonList - 获取可用 F1 赛季列表
  17. getQualifyingResults - 获取排位赛结果
  18. getDriverInformation - 从 Ergast API 获取详细车手信息
  19. getConstructorInformation - 从 Ergast API 获取详细车队信息
  20. clearCache - 清除 F1 数据的本地缓存

常见问题解答

  • 数据来源:实时数据来自 F1 Live Timing API (OpenF1),历史数据来自 Ergast API (FastF1)
  • 问题报告:可通过 GitHub 提交 issue
  • 调试工具:建议使用 MCP Inspector 进行调试

使用教程

使用依赖

需要安装 Node.js 和 npm

安装教程

快速安装(通过 Smithery)

npx -y @smithery/cli install @Panth1823/formula1-mcp --client claude

手动安装

  1. 克隆仓库
git clone https://github.com/Panth1823/formula1-mcp
cd formula1-mcp
  1. 安装依赖
npm install
  1. 构建项目
npm run build

调试方式

  1. 将服务添加到 MCP 客户端配置中
{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": ["<path-to-your-cloned-repo>/build/index.js"],
      "cwd": "<path-to-your-cloned-repo>",
      "enabled": true
    }
  }
}
  1. 配置文件位置:
  2. Windows: %APPDATA%\.cursor\mcp.json
  3. MacOS: ~/.cursor/mcp.json
  4. Linux: ~/.config/.cursor/mcp.json

  5. 使用 MCP Inspector 进行调试

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。