
The Formula1 MCP Server ! 🏎️💨

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 粉丝网站和社区
- 赛车游戏和模拟器
- 体育新闻报道
- 赛车历史研究
工具列表
getLiveTimingData
- 获取当前赛段的实时计时数据getCurrentSessionStatus
- 获取当前赛段状态信息getDriverInfo
- 获取特定车手信息getHistoricalSessions
- 查找历史赛事的赛段密钥getHistoricRaceResults
- 获取特定历史比赛结果getDriverStandings
- 获取车手锦标赛排名getConstructorStandings
- 获取车队锦标赛排名getLapTimes
- 获取特定车手的圈速getWeatherData
- 获取赛段天气数据getCarData
- 获取详细的赛车遥测数据getPitStopData
- 获取进站信息getTeamRadio
- 获取车队无线电通讯getRaceControlMessages
- 获取比赛控制消息getRaceCalendar
- 获取 F1 比赛日历getCircuitInfo
- 获取详细赛道信息getSeasonList
- 获取可用 F1 赛季列表getQualifyingResults
- 获取排位赛结果getDriverInformation
- 从 Ergast API 获取详细车手信息getConstructorInformation
- 从 Ergast API 获取详细车队信息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
手动安装
- 克隆仓库
git clone https://github.com/Panth1823/formula1-mcp
cd formula1-mcp
- 安装依赖
npm install
- 构建项目
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
-
使用 MCP Inspector 进行调试