フォーミュラワン MCP サーバー

F1レースデータを提供するモデルコンテキストプロトコル（MCP）サーバー。このパッケージは、イベントスケジュール、ドライバー情報、テレメトリデータ、レース結果など、F1データを照会するための様々なツールを公開しています。

特徴

• イベントスケジュール: どのシーズンでも完全なF1レースカレンダーにアクセスできます

• イベント情報：特定のグランプリイベントに関する詳細データ

• セッション結果: レース、予選セッション、スプリント、練習セッションの総合結果

• ドライバー情報: 特定のセッションのドライバーの詳細にアクセスします

• パフォーマンス分析: ラップタイム統計でドライバーのパフォーマンスを分析する

• ドライバー比較: 同じセッションで複数のドライバーのパフォーマンスを比較します

• テレメトリデータ: 特定のラップの詳細なテレメトリにアクセスします

• チャンピオンシップ順位表: どのシーズンでもドライバーとコンストラクターの順位表を表示

Related MCP server: Formula1 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-server

SSE トランスポート モード(Web アプリケーション用):

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

Python 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 ドキュメント

依存関係

• 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/

寄稿ガイドライン

1. リポジトリをフォークする

2. 機能ブランチを作成する: git checkout -b feature-name

3. 変更をコミットします: git commit -am 'Add some feature'

4. ブランチにプッシュ: git push origin feature-name

5. プルリクエストを送信する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

著者

• マシンツーマシン

謝辞

このプロジェクトは、F1データにアクセスするための優れたPythonパッケージであるFastF1を活用しています。FastF1のメンテナーと貢献者の皆様に感謝申し上げます。

このプロジェクトは、TypeScriptで書かれたrakeshgangwar/f1-mcp-serverに触発されました。f1_data.pyモジュールはf1_data.py主にそのソースコードから改変したものです。