Skip to main content
Glama
Formula One MCP Server (Python)

Formula One MCP Server (Python)

포뮬러 원 MCP 서버

PyPI 버전 파이썬 버전 라이센스: MIT 대장간 배지

포뮬러 원 레이싱 데이터를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 패키지는 이벤트 일정, 드라이버 정보, 원격 측정 데이터, 레이스 결과 등 F1 데이터 쿼리를 위한 다양한 도구를 제공합니다.

특징

  • 이벤트 일정 : 모든 시즌의 전체 F1 레이스 일정에 액세스하세요

  • 이벤트 정보 : 특정 그랑프리 이벤트에 대한 자세한 데이터

  • 세션 결과 : 레이스, 예선 세션, 스프린트 및 연습 세션의 종합적인 결과

  • 운전자 정보 : 특정 세션에 대한 운전자 세부 정보에 액세스합니다.

  • 성능 분석 : 랩 타임 통계를 통해 드라이버의 성능을 분석합니다.

  • 드라이버 비교 : 동일한 세션에서 여러 드라이버의 성과를 비교합니다.

  • 원격 측정 데이터 : 특정 랩에 대한 자세한 원격 측정에 액세스

  • 챔피언십 순위 : 모든 시즌의 드라이버 및 생성자 순위를 확인하세요.

Related MCP server: Formula One MCP Server

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 f1-mcp-server를 자동으로 설치하려면:

지엑스피1

수동 설치

uv 관리형 Python 프로젝트에서 다음을 사용하여 종속성을 추가합니다.

uv add f1-mcp-server

또는 종속성을 위해 pip 사용하는 프로젝트의 경우:

pip install f1-mcp-server

프로젝트 내에서 서버를 실행하려면:

uv run f1-mcp-server

또는 격리된 환경에서 전역적으로 실행하려면:

uvx f1-mcp-server

소스에서 직접 설치하려면:

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
pip install -e .

용법

명령줄

서버는 두 가지 모드로 실행될 수 있습니다.

표준 I/O 모드 (기본값):

uvx run f1-mcp-server

SSE 전송 모드 (웹 애플리케이션용):

uvx f1-mcp-server --transport sse --port 8000

파이썬 API

from f1_mcp_server import main

# Run the server with default settings
main()

# Or with SSE transport settings
main(port=9000, transport="sse")

API 문서

서버는 MCP를 통해 다음 도구를 제공합니다.

도구 이름

설명

get_event_schedule

특정 시즌의 포뮬러 원 레이스 일정을 확인하세요

get_event_info

특정 포뮬러 원 그랑프리에 대한 자세한 정보를 얻으세요

get_session_results

특정 포뮬러 원 세션에 대한 결과를 얻으세요

get_driver_info

특정 포뮬러 원 드라이버에 대한 정보를 얻으세요

analyze_driver_performance

포뮬러 원 세션에서 드라이버의 성과 분석

compare_drivers

여러 포뮬러 원 드라이버 간의 성과를 비교하세요

get_telemetry

특정 포뮬러 원 랩에 대한 원격 측정 데이터 가져오기

get_championship_standings

포뮬러 원 챔피언십 순위를 확인하세요

기본 데이터에 대한 자세한 정보는 FastF1 설명서를 참조하세요. FastF1 설명서

종속성

  • 애니오(>=4.9.0)

  • 클릭 (>=8.1.8)

  • fastf1 (>=3.5.3)

  • mcp (>=1.6.0)

  • 넘파이(>=2.2.4)

  • 판다스(>=2.2.3)

  • 유비콘 (>=0.34.0)

개발

개발 환경 설정

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"

코드 품질

# Run linting
uv run ruff check .

# Run formatting check
uv run ruff format --check .

# Run security checks
uv run bandit -r src/

기여 지침

  1. 저장소를 포크하세요

  2. 기능 브랜치를 생성합니다: git checkout -b feature-name

  3. 변경 사항을 커밋하세요: git commit -am 'Add some feature'

  4. 브랜치에 푸시: git push origin feature-name

  5. 풀 리퀘스트 제출

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

저자

  • 기계 대 기계

감사의 말

이 프로젝트는 포뮬러 1 데이터 접근을 위한 훌륭한 Python 패키지인 FastF1 활용합니다. FastF1의 유지 관리자와 기여자 여러분께 감사드립니다.

이 프로젝트는 TypeScript로 작성된 rakeshgangwar/f1-mcp-server 에서 영감을 받았습니다. f1_data.py 모듈은 대부분 해당 소스 코드를 기반으로 수정되었습니다.

Available Tools

8 tools
analyze_driver_performanceC

Analyze a driver's performance in a Formula One session

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required).

compare_driversB

Compare performance between multiple Formula One drivers

Inputs: year (required), event_identifier (required), session_name (required), drivers (required).

get_championship_standingsC

Get Formula One championship standings

Inputs: year (required), round_num.

get_driver_infoC

Get information about a specific Formula One driver

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required).

get_event_infoB

Get detailed information about a specific Formula One Grand Prix

Inputs: year (required), identifier (required).

get_event_scheduleA

Get Formula One race calendar for a specific season

Inputs: year (required).

get_session_resultsC

Get results for a specific Formula One session

Inputs: year (required), event_identifier (required), session_name (required).

get_telemetryC

Get telemetry data for a specific Formula One lap

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    All 8 tools target distinct aspects of Formula One data—drivers, events, sessions, championships, and telemetry—with no overlapping functionality. Each has a clear, non-redundant purpose.

    Naming Consistency5/5

    Every tool uses a consistent verb_noun pattern with lowercase and underscores (e.g., get_driver_info, analyze_driver_performance). The naming is predictable and adheres to a single convention.

    Tool Count5/5

    With 8 tools, the server is well-scoped for its domain. It covers essential F1 operations without being too sparse or overly granular, making it ideal for most common queries without excessive complexity.

    Completeness4/5

    The tool set covers major areas: driver info, performance analysis, comparisons, standings, event details, schedule, session results, and telemetry. One minor gap is lack of team/constructor info, but the surface is otherwise comprehensive for a dedicated F1 server.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time and historical Formula 1 racing data through the Model Context Protocol, offering access to timing data, driver stats, race results, telemetry, and more.
      14
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that provides comprehensive Formula One racing data, enabling access to event schedules, driver information, telemetry data, race results, and performance analytics through natural language queries.
      8
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Formula 1 data via the FastF1 library. Ask Claude (or any MCP-compatible client) about race results, lap times, telemetry, standings, pit stops, and qualifying — with historical data back to 1950 via the Ergast API.
      21
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A local MCP server that gives Claude (or any MCP-compatible AI client) access to Formula 1 race data. Load any session from 2018 onwards, ask questions in natural language, and get answers backed by real telemetry, timing, and strategy data.
      17
      1
      MIT