Formula One MCP Server (Python)
フォーミュラワン MCP サーバー
F1レースデータを提供するモデルコンテキストプロトコル(MCP)サーバー。このパッケージは、イベントスケジュール、ドライバー情報、テレメトリデータ、レース結果など、F1データを照会するための様々なツールを公開しています。
特徴
イベントスケジュール: どのシーズンでも完全なF1レースカレンダーにアクセスできます
イベント情報:特定のグランプリイベントに関する詳細データ
セッション結果: レース、予選セッション、スプリント、練習セッションの総合結果
ドライバー情報: 特定のセッションのドライバーの詳細にアクセスします
パフォーマンス分析: ラップタイム統計でドライバーのパフォーマンスを分析する
ドライバー比較: 同じセッションで複数のドライバーのパフォーマンスを比較します
テレメトリデータ: 特定のラップの詳細なテレメトリにアクセスします
チャンピオンシップ順位表: どのシーズンでもドライバーとコンストラクターの順位表を表示
Related MCP server: Formula One MCP Server
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop 用の f1-mcp-server を自動的にインストールするには:
npx -y @smithery/cli install @Machine-To-Machine/f1-mcp-server --client claude手動インストール
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 .使用法
コマンドライン
サーバーは次の 2 つのモードで実行できます。
標準I/Oモード(デフォルト):
uvx run f1-mcp-serverSSE トランスポート モード(Web アプリケーション用):
uvx f1-mcp-server --transport sse --port 8000Python 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 を介して次のツールを公開します。
ツール名 | 説明 |
| 特定のシーズンのF1レースカレンダーを取得する |
| 特定のF1グランプリに関する詳細情報を入手 |
| 特定のF1セッションの結果を取得する |
| 特定のF1ドライバーに関する情報を取得する |
| F1セッションでのドライバーのパフォーマンスを分析する |
| 複数のF1ドライバーのパフォーマンスを比較する |
| 特定のF1ラップのテレメトリデータを取得する |
| F1チャンピオンシップの順位表を見る |
基礎データの詳細については、FastF1 ドキュメントを参照してください: FastF1 ドキュメント
依存関係
anyio (>=4.9.0)
クリック (>=8.1.8)
fastf1 (>=3.5.3)
mcp (>=1.6.0)
numpy (>=2.2.4)
パンダ (>=2.2.3)
uvicorn (>=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 ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
著者
マシンツーマシン
謝辞
このプロジェクトは、F1データにアクセスするための優れたPythonパッケージであるFastF1を活用しています。FastF1のメンテナーと貢献者の皆様に感謝申し上げます。
このプロジェクトは、TypeScriptで書かれたrakeshgangwar/f1-mcp-serverに触発されました。f1_data.pyモジュールは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