JinDaGe - Formula 1 MCP Details

article

README

🚀 Formula1 MCP 服务器 🏎️💨

Formula1 MCP 服务器基于 TypeScript 构建，能通过模型上下文协议，将实时和历史 F1 赛车数据直接送到您手中。虽比不上维斯塔潘在热圈的速度，但它也在奋力追赶！

🚀 快速开始

Formula1 MCP 服务器可让你轻松获取各类 F1 数据。你只需完成安装和配置，就能使用丰富的 API 接口获取所需信息。

✨ 主要特性

丰富的数据资源：可通过标准 URI 访问 F1 会话数据，涵盖实时计时数据（OpenF1）、历史数据（Ergast API/FastF1）、车手信息、赛车构造商信息、大奖赛信息、日历以及天气和环境数据。
便捷的数据获取：提供多种 API 接口，能方便地获取实时数据、历史数据、车手信息、赛车构造商信息和大奖赛信息。

📦 安装指南

使用 Smithery 快速安装

smithy add github:Panther-FML/Formula1-MCP

手动安装

克隆仓库：

git clone https://github.com/Panther-FML/Formula1-MCP.git
cd Formula1-MCP

安装依赖：

npm install

构建：

npm run build

🛠️ 配置说明

将以下内容添加到您的 MCP 配置文件中：

{
  "formula1": {
    "enabled": true,
    "path": "./dist/index.js",
    "args": [],
    "env": {},
    "cwd": "./Formula1-MCP"
  }
}

💻 使用示例

基础用法

// 获取2023赛季车手积分榜
const standings = await getSeasonStandings(2023);

// 获取日本大奖赛的结果
const japanResults = await getHistoricalResults(2023, 18);

// 获取刘易斯·汉密尔顿的统计数据
const hamiltonStats = await getDriverStatistics("hamilton");

📚 详细文档

功能接口详情

获取实时数据

getLiveTimingData(): 获取当前比赛的实时计时数据。
getCurrentSessionStatus(): 获取当前会话的状态信息。

获取历史数据

getHistoricalResults(year, raceNumber): 获取指定年份和场次的比赛结果。
getSeasonStandings(year): 获取指定年份的车手积分榜。
getConstructorStandings(year): 获取指定年份的车队积分榜。

获取车手信息

getDriverInformation(driverId): 获取指定车手的详细信息，包括职业生涯统计数据。
getDriverStatistics(driverId): 获取指定车手的统计信息，如比赛次数、获胜次数等。

获取赛车构造商信息

getConstructorInformation(constructorId): 获取指定车队的详细信息，包括赛车规格和历史成绩。

获取大奖赛信息

getGrandPrixSchedule(year): 获取指定年份的大奖赛日历。
getCircuitDetails(circuitId): 获取指定赛道的详细信息，如长度、布局和记录。

数据源说明

实时数据：F1 直播计时 API（OpenF1）
历史数据：Ergast API（FastF1）

🐞 调试指南

使用 MCP Inspector 进行调试。

💬 支持与帮助

遇到问题？在此报告
有疑问？打开问题
想要帮忙？提交 PR

📄 许可证

本项目遵循 MIT 许可证 - 详情请参阅 LICENSE 文件。

Formula 1