MCP-сервер Формулы 1! 🏎️💨

MCP-сервер Формулы 1 на базе TypeScript, который позволяет получить острые ощущения от реальных и исторических данных гонок Формулы 1 прямо к вашим кончикам пальцев через протокол контекста модели. Быстрее Ферстаппена на горячем круге! (Ладно, может, не так быстро, но он пытается!)

Ресурсы

• Доступ к данным сеанса F1 через стандартизированные URI

• Данные телеметрии в реальном времени

• Историческая информация о гонке

• Зачет среди водителей и конструкторов

• Данные о погоде

• Информация о схеме

Начиная

Быстрая установка через Smithery

Чтобы автоматически установить сервер Formula 1 MCP через Smithery:

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

Related MCP server: Formula One MCP Server (Python)

Настраивать

Добавьте в конфигурацию вашего клиента 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 (строка): идентификатор водителя (например, "max_verstappen", "lewis_hamilton")

4. getHistoricalSessions

Найдите сеансовые ключи для исторических событий.

Параметры:

• year (число, необязательно): Год сезона (например, 2023)

• circuit_short_name (строка, необязательно): Название трассы (например, «monza», «spa»)

• country_name (строка, необязательно): Название страны (например, «Италия», «Бельгия»)

• session_name (строка, необязательно): Тип сеанса (например, «Гонка», «Квалификация»)

5. getHistoricRaceResults

Получите результаты конкретной исторической гонки.

Параметры:

• year (число): Год сезона (например, 2023)

• round (номер): Номер гонки (например, 1, 2, 3)

6. getDriverStandings

Получите результаты чемпионата среди водителей.

Параметры:

• year (число): Год сезона (например, 2023)

7. getConstructorStandings

Получите турнирную таблицу чемпионата конструкторов.

Параметры:

• year (число): Год сезона (например, 2023)

8. getLapTimes

Получите время круга для конкретного водителя.

Параметры:

• year (число): Год сезона (например, 2023)

• round (номер): Номер гонки (например, 1, 2, 3)

• driverId (строка): идентификатор водителя (например, "max_verstappen", "lewis_hamilton")

9. getWeatherData

Получите данные о погоде для сеанса.

Параметры:

• sessionKey (строка, необязательно): идентификатор сеанса

10. getCarData

Получите подробные данные телеметрии автомобиля.

Параметры:

• driverNumber (строка): Номер автомобиля водителя (например, «44», «33»)

• sessionKey (строка, необязательно): идентификатор сеанса

• filters (строка, необязательно): Фильтры данных

11. getPitStopData

Получите информацию о пит-стопах.

Параметры:

• driverNumber (строка, необязательно): Номер автомобиля водителя

• sessionKey (строка, необязательно): идентификатор сеанса

12. getTeamRadio

Обеспечьте радиосвязь с командой.

Параметры:

• driverNumber (строка, необязательно): Номер автомобиля водителя

• sessionKey (строка, необязательно): идентификатор сеанса

13. getRaceControlMessages

Получайте сообщения о контроле за гонкой.

Параметры:

• sessionKey (строка, необязательно): идентификатор сеанса

14. getRaceCalendar

Получите календарь гонок Формулы-1.

Параметры:

• year (число): Год сезона (например, 2023)

15. getCircuitInfo

Получите подробную информацию о схеме.

Параметры:

• circuitId (строка): идентификатор трассы (например, «monza», «spa»)

16. getSeasonList

Получите список доступных сезонов Формулы-1.

Параметры:

• limit (число, необязательно): количество сезонов для возврата

17. getQualifyingResults

Получите результаты квалификационной сессии.

Параметры:

• year (число): Год сезона (например, 2023)

• round (номер): Номер гонки (например, 1, 2, 3)

18. getDriverInformation

Получите подробную информацию о драйверах из API Ergast.

Параметры:

• driverId (строка): идентификатор водителя (например, "max_verstappen", "lewis_hamilton")

19. getConstructorInformation

Получите подробную информацию о конструкторе из Ergast API.

Параметры:

• constructorId (строка): идентификатор конструктора (например, "red_bull", "mercedes")

20. clearCache

Очистите локальный кэш данных F1.

Параметры:

• Не требуется

Источники данных

• Текущие данные: API F1 Live Timing (OpenF1)

• Исторические данные: Ergast API (FastF1)

Примеры

• "Показать результаты Гран-при Монако 2023 года"

• "Получить текущее положение"

• "Погода в Сильверстоуне"

• "Время круга Гамильтона"

• "Показать календарь 2024"

• "Информация Ферстаппена"

• "Квалификация Гран-при Японии"

Отлаживать

Используйте MCP Inspector для отладки.

Помощь

• Ошибки? Сообщить здесь

• Вопросы? Открыть вопрос

• Хотите помочь? Отправьте PR

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .