Formula One MCP Server (Python)
포뮬러 원 MCP 서버
포뮬러 원 레이싱 데이터를 제공하는 모델 컨텍스트 프로토콜(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-serverSSE 전송 모드 (웹 애플리케이션용):
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/기여 지침
저장소를 포크하세요
기능 브랜치를 생성합니다:
git checkout -b feature-name변경 사항을 커밋하세요:
git commit -am 'Add some feature'브랜치에 푸시:
git push origin feature-name풀 리퀘스트 제출
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
저자
기계 대 기계
감사의 말
이 프로젝트는 포뮬러 1 데이터 접근을 위한 훌륭한 Python 패키지인 FastF1 활용합니다. FastF1의 유지 관리자와 기여자 여러분께 감사드립니다.
이 프로젝트는 TypeScript로 작성된 rakeshgangwar/f1-mcp-server 에서 영감을 받았습니다. f1_data.py 모듈은 대부분 해당 소스 코드를 기반으로 수정되었습니다.
Available Tools
8 toolsanalyze_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Primarily to be used as a template repository for developing MCP servers with FastMCP in Python, P…
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A simple MCP server built with FastMCP and python
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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.14MIT
- AlicenseAqualityDmaintenanceA 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.81MIT
- AlicenseAqualityCmaintenanceMCP 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.21MIT
- AlicenseAqualityDmaintenanceA 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.171MIT