Formula1 MCP 服务器！🏎️💨

一个基于 TypeScript 的 Formula 1 MCP 服务器，通过模型上下文协议 (Model Context Protocol) 将实时和历史 F1 赛车数据的刺激直接带到您的指尖。比维斯塔潘在热圈上还快！（好吧，也许没_那么_快，但它正在努力！）

资源

• 通过标准化 URI 访问 F1 会话数据
• 实时遥测数据
• 历史比赛信息
• 车手和车队积分榜
• 天气数据
• 赛道信息

快速开始

通过 Smithery 快速安装

要通过 Smithery 自动安装 Formula 1 MCP 服务器：

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

手动安装

1. 克隆仓库：

git clone https://github.com/Panth1823/formula1-mcp
cd formula1-mcp

2. 安装：

npm install

3. 构建：

npm run build

设置

添加到您的 MCP 客户端配置：

{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": ["<path-to-your-cloned-repo>/build/index.js"],
      "cwd": "<path-to-your-cloned-repo>",
      "enabled": true
    }
  }
}

配置位置：

• Windows: %APPDATA%\.cursor\mcp.json
• MacOS: ~/.cursor/mcp.json
• Linux: ~/.config/.cursor/mcp.json

可用工具

1. getLiveTimingData

获取当前会话的实时计时数据。

参数：

• 无需参数

2. getCurrentSessionStatus

获取有关当前会话的状态信息。

参数：

• 无需参数

3. getDriverInfo

获取有关特定车手的信息。

参数：

• driverId (string): 车手标识符（例如，“max_verstappen”，“lewis_hamilton”）

4. getHistoricalSessions

查找历史事件的会话密钥。

参数：

• year (number, optional): 赛季年份（例如，2023）
• circuit_short_name (string, optional): 赛道名称（例如，“monza”，“spa”）
• country_name (string, optional): 国家名称（例如，“Italy”，“Belgium”）
• session_name (string, optional): 会话类型（例如，“Race”，“Qualifying”）

5. getHistoricRaceResults

获取特定历史比赛的比赛结果。

参数：

• year (number): 赛季年份（例如，2023）
• round (number): 比赛轮次（例如，1、2、3）

6. getDriverStandings

获取车手锦标赛积分榜。

参数：

• year (number): 赛季年份（例如，2023）

7. getConstructorStandings

获取车队锦标赛积分榜。

参数：

• year (number): 赛季年份（例如，2023）

8. getLapTimes

获取特定车手的单圈时间。

参数：

• year (number): 赛季年份（例如，2023）
• round (number): 比赛轮次（例如，1、2、3）
• driverId (string): 车手标识符（例如，“max_verstappen”，“lewis_hamilton”）

9. getWeatherData

获取会话的天气数据。

参数：

• sessionKey (string, optional): 会话标识符

10. getCarData

获取详细的赛车遥测数据。

参数：

• driverNumber (string): 车手的赛车号码（例如，“44”，“33”）
• sessionKey (string, optional): 会话标识符
• filters (string, optional): 数据过滤器

11. getPitStopData

获取维修站信息。

参数：

• driverNumber (string, optional): 车手的赛车号码
• sessionKey (string, optional): 会话标识符

12. getTeamRadio

获取车队无线电通讯。

参数：

• driverNumber (string, optional): 车手的赛车号码
• sessionKey (string, optional): 会话标识符

13. getRaceControlMessages

获取比赛控制消息。

参数：

• sessionKey (string, optional): 会话标识符

14. getRaceCalendar

获取 F1 比赛日历。

参数：

• year (number): 赛季年份（例如，2023）

15. getCircuitInfo

获取详细的赛道信息。

参数：

• circuitId (string): 赛道标识符（例如，“monza”，“spa”）

16. getSeasonList

获取可用的 F1 赛季列表。

参数：

• limit (number, optional): 要返回的赛季数量

17. getQualifyingResults

获取排位赛结果。

参数：

• year (number): 赛季年份（例如，2023）
• round (number): 比赛轮次（例如，1、2、3）

18. getDriverInformation

从 Ergast API 获取详细的车手信息。

参数：

• driverId (string): 车手标识符（例如，“max_verstappen”，“lewis_hamilton”）

19. getConstructorInformation

从 Ergast API 获取详细的车队信息。

参数：

• constructorId (string): 车队标识符（例如，“red_bull”，“mercedes”）

20. clearCache

清除 F1 数据的本地缓存。

参数：

• 无需参数

数据来源

• 实时数据：F1 Live Timing API (OpenF1)
• 历史数据：Ergast API (FastF1)

示例

• “显示 2023 年摩纳哥大奖赛结果”
• “获取当前积分榜”
• “银石赛道的天气”
• “汉密尔顿的单圈时间”
• “显示 2024 年日历”
• “维斯塔潘的信息”
• “日本大奖赛排位赛”

调试

使用 MCP Inspector 进行调试。

帮助

• 错误？在此处报告
• 问题？打开一个 issue
• 想要帮忙？提交一个 PR

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。