F1 MCP сервер

MCP сервер, который предоставляет доступ к данным Формулы 1, включая результаты гонок, информацию о гонщиках, время прохождения кругов, телеметрию и детали трасс с использованием библиотеки FastF1.

Установка

pip

pip install f1-mcp

Hatch

hatch run f1_mcp_server.py

Прямой запуск Python

python src/f1_mcp/f1_mcp_server.py

MCP Inspector

npx @modelcontextprotocol/inspector python src/f1_mcp/f1_mcp_server.py

Конфигурация

Claude Desktop

{
  "mcpServers": {
    "f1-stats": {
      "command": "python",
      "args": ["path/to/your/f1_mcp_server.py"],
      "env": {}
    }
  }
}

Доступные инструменты

Инструмент	Описание
`get_drivers_tool`	Получение гонщиков F1 за сезон с возможностью фильтрации по имени или коду
`get_race_results_tool`	Получение результатов гонок за сезон с возможностью фильтрации по конкретному названию гонки
`get_session_results_tool`	Получение результатов сессии для конкретной гонки и типа сессии (FP1, FP2, FP3, Qualifying, Sprint, Race)
`get_circuit_info_tool`	Получение информации о трассе и деталей события для конкретной гонки
`get_driver_laps_tool`	Получение всех данных о кругах конкретного гонщика в конкретной сессии
`get_fastest_lap_tool`	Получение информации о самом быстром круге для конкретной сессии
`get_lap_telemetry_tool`	Получение детальных данных телеметрии (скорость, газ, тормоза и т.д.) для конкретного круга

Возможности

Доступ к результатам гонок Формулы 1 и информации о гонщиках
Получение времени прохождения кругов и данных телеметрии
Детали трасс и информация о событиях
Данные по конкретным сессиям для FP1, FP2, FP3, Qualifying, Sprint и Race
Автоматическое локальное кэширование данных F1 для улучшения производительности
Поддержка фильтрации гонщиков по имени или 3-буквенным кодам

Ресурсы

GitHub Repository

Примечания

Убедитесь, что установили большой таймаут для запросов, поскольку FastF1 требует много времени для загрузки данных при запуске. Сервер создает локальную директорию кэша (f1_data_cache) для хранения данных F1 с целью ускорения последующих запросов. Первые запросы за сезон могут занять больше времени, поскольку данные загружаются и кэшируются. Типы сессий включают: FP1, FP2, FP3, Q1, Q2, Q3, Sprint, Race. Коды гонщиков обычно представляют собой 3-буквенные сокращения (например, HAM, VER, LEC).