포뮬러 원 MCP 서버

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

특징

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

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

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

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

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

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

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

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

Related MCP server: Formula1 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를 통해 다음 도구를 제공합니다.

기본 데이터에 대한 자세한 정보는 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 모듈은 대부분 해당 소스 코드를 기반으로 수정되었습니다.