11種類の専用ツールを通じて、Formula 1のリアルタイムデータ、履歴データ、およびニュースデータを提供します。
別名 praneethravuri/pitstop, pitstop-f1
- スター
- 1
- ツール
- 11
- ダウンロード数(30日間)
- 65
- 最新バージョン
- 0.5.0
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
Pitstop MCPとは
11種類の専用ツールを通じて、Formula 1のリアルタイムデータ、履歴データ、およびニュースデータを提供します。 11個のツールを提供しており、get_session_data, get_telemetry_data, get_live_dataなどがあります。
プロジェクトのREADMEから生成された概要
Pitstop MCP server について
pitstopは、AIクライアント内からFormula 1のテレメトリ、レース結果、ニュースを分析することを可能にします。このMCP serverは、FastF1、OpenF1、Wikidataなどの複数の信頼できるソースからデータを集約し、レーシングファンや開発者向けに11種類の専用ツールを提供します。リアルタイムのライブインターバルやピットストップから、1950年まで遡る歴史的なチャンピオンシップの順位まで、あらゆる情報を網羅しています。
ユーザーは、Hugging Face上のホストされたHTTPエンドポイント経由でこのサーバーをデプロイするか、uvxを使用してstdio経由でローカルにインストールできます。Claude Desktop、Cursor、Windsurf、VS Codeを含むさまざまな環境をサポートしています。完全なローカルセットアップが必要な場合は、内部のSQLiteデータベースを含めるためにDocker経由で実行することも可能です。このサーバーは、信頼性の高いデータ取得を保証するために、ページネーション、リトライ、並行実行制限などの複雑なタスクを自動的に管理します。
できること
- 1ドライバーのパフォーマンス分析特定のグランプリにおけるドライバーのペース、タイヤのデグラデーション、スティントの安定性に関する詳細な分析をリクエストします。
- 2ライブレースデータのモニタリングライブセッション中のリアルタイムのレースインターバル、ピットストップ、チーム無線のアップデートを追跡します。
- 3履歴テレメトリの取得特定のドライバーの速度、スロットル、ギアチェンジを含むラップごとの車両テレメトリを調査します。
- 4経歴情報の照会SPARQLクエリを使用して、Formula 1ドライバーの特定の経歴情報やキャリア記録を検索します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Pitstop MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにPitstop MCPをインストール
$ claude mcp add --env 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' pitstop -- uvx pitstop-f1CursorにPitstop MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}VS CodeにPitstop MCPをインストール
.vscode/mcp.json
{
"servers": {
"pitstop": {
"type": "stdio",
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}VS Code CLIにPitstop MCPをインストール
$ code --add-mcp '{"name":"pitstop","type":"stdio","command":"uvx","args":["pitstop-f1"],"env":{"PITSTOP_TRANSPORT":"<PITSTOP_TRANSPORT>"}}'Claude DesktopにPitstop MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}CodexにPitstop MCPをインストール
$ codex mcp add pitstop --env 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' -- uvx pitstop-f1Codex config.tomlにPitstop MCPをインストール
~/.codex/config.toml
[mcp_servers.pitstop] command = "uvx" args = ["pitstop-f1"] [mcp_servers.pitstop.env] PITSTOP_TRANSPORT = "<PITSTOP_TRANSPORT>"
Gemini CLIにPitstop MCPをインストール
$ gemini mcp add -s user -e 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' pitstop uvx -- pitstop-f1Gemini settings.jsonにPitstop MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}Pitstop MCPツール 11
READMEから検出get_session_dataget_telemetry_dataget_live_dataget_standingsget_scheduleget_reference_dataget_f1_newsget_resultsget_race_analysisquery_wikidataquery_f1_database
| get_session_data | — | |
| get_telemetry_data | — | |
| get_live_data | — | |
| get_standings | — | |
| get_schedule | — | |
| get_reference_data | — | |
| get_f1_news | — | |
| get_results | — | |
| get_race_analysis | — | |
| query_wikidata | — | |
| query_f1_database | — |
設定
PITSTOP_TRANSPORT必須Transport mode; must be 'stdio' when run via an MCP client.
| 名前 | 説明 | 種類 |
|---|---|---|
| PITSTOP_TRANSPORT | Transport mode; must be 'stdio' when run via an MCP client. | 必須 |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るPitstop — F1 MCP Server
An HTTP-first Model Context Protocol (MCP) server for Formula 1 data. Aggregates real-time, historical, and news data from multiple authoritative sources into 11 tools ready for any MCP client.
v0.5.0 | Author: Praneeth Ravuri
Install
Hosted endpoint (nothing to install)
A free public instance runs on Hugging Face Spaces:
https://praneeth1025-pitstop.hf.space/mcp
claude mcp add --transport http pitstop https://praneeth1025-pitstop.hf.space/mcp
Note: the Space sleeps after long inactivity — the first request after a quiet spell takes a cold start.
Local install
stdio, via uvx (no clone needed):
PITSTOP_TRANSPORT=stdio uvx pitstop-f1
claude mcp add pitstop -e PITSTOP_TRANSPORT=stdio -- uvx pitstop-f1
codex mcp add pitstop --env PITSTOP_TRANSPORT=stdio -- uvx pitstop-f1
gemini mcp add pitstop uvx pitstop-f1 --env PITSTOP_TRANSPORT=stdio
VS Code:
code --add-mcp '{"name":"pitstop","command":"uvx","args":["pitstop-f1"],"env":{"PITSTOP_TRANSPORT":"stdio"}}'
Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), and Windsurf (~/.codeium/windsurf/mcp_config.json) share the same JSON shape:
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": ["pitstop-f1"],
"env": { "PITSTOP_TRANSPORT": "stdio" }
}
}
}
Docker (HTTP transport, runs the full server incl. the F1 database):
docker compose up
# → http://localhost:8000/mcp
Overview
Pitstop exposes F1 data as 11 MCP tools over HTTP (default) or stdio. It pulls from FastF1, Jolpica, OpenF1, Wikidata, RSS feeds, and its own seeded F1 database, handling pagination, retries, caching, and concurrency limits transparently.
Data Sources
| Source | Coverage | Type |
|---|---|---|
| FastF1 | 2018–present | Historical / timing / telemetry |
| Jolpica-F1 | 1950–present | Historical (Ergast-compatible) |
| OpenF1 | 2023–present | Real-time |
| Wikidata | All eras | SPARQL queries |
| RSS Feeds (20 sources) | Live | News |
| Pitstop F1 Database | 1950–present | Owned sqlite (seeded from F1DB, self-updated weekly from Jolpica) + per-lap times |
Database refresh: .github/workflows/db-update.yml runs weekly to pull new Jolpica results into the owned F1 database.
Tools
| Tool | Description | Key Parameters |
|---|---|---|
get_session_data |
Race/qualifying results, lap times, weather, driver details (2018–present) | year, gp, session, includes, page, page_size |
get_telemetry_data |
Lap-by-lap car telemetry (speed, throttle, brake, gears) (2018–present) | year, gp, session, drivers, lap_numbers, max_points, page, page_size |
get_live_data |
Live intervals, pit stops, team radio, stints, race control, weather, position, laps, overtakes (2023–present) | data_types, year, country, session_name, driver_number, compound, flag, category, page, page_size |
get_standings |
Driver and constructor championship standings (1950–present) | year, round, type, driver_name, team_name, page, page_size |
get_schedule |
Race calendar and session schedule | year, include_testing, round, event_name, only_remaining, page, page_size |
get_reference_data |
Circuits, drivers, constructors encyclopedia (1950–present) | reference_type, year, name, page, page_size |
get_f1_news |
F1 headlines from 20 RSS sources | source, limit, keywords, driver, team, circuit, year, date_from, date_to, page, page_size |
get_results |
Race/qualifying/sprint results, lap times, pit stops (1950–present) | year, round, result_type, driver, page |
get_race_analysis |
Pace, tire degradation, stint summaries, consistency (2018–present) | year, gp, session, drivers, analysis_type, page |
query_wikidata |
SPARQL queries to Wikidata for F1 biography, career records, history | sparql, page, page_size |
query_f1_database |
Read-only SQL over pitstop's owned F1 database (1950–present): results, standings, driver family trees, team lineage | sql, page, page_size |
Transport
HTTP (default)
uv sync
uv run pitstop
# → http://localhost:8000
MCP client config:
{
"mcpServers": {
"pitstop": {
"type": "http",
"url": "http://localhost:8000/mcp"
}
}
}
stdio (opt-in)
PITSTOP_TRANSPORT=stdio uv run pitstop
MCP client config:
{
"mcpServers": {
"pitstop": {
"command": "uv",
"args": ["run", "--directory", "/path/to/pitstop", "pitstop"],
"env": { "PITSTOP_TRANSPORT": "stdio" }
}
}
}
Health API
| Endpoint | Purpose |
|---|---|
GET /health |
Per-source status (FastF1, f1db, Jolpica, OpenF1, RSS) |
GET /live |
Liveness probe |
GET /ready |
Readiness probe |
Example /health response:
{
"version": "0.5.0",
"overall": "ok",
"sources": [
{ "name": "fastf1", "status": "ok", "latency_ms": 2, "detail": "cache writable" },
{ "name": "f1db", "status": "ok", "latency_ms": 1, "detail": "" },
{ "name": "jolpica", "status": "ok", "latency_ms": 134, "detail": "" },
{ "name": "openf1", "status": "ok", "latency_ms": 98, "detail": "" },
{ "name": "rss", "status": "ok", "latency_ms": 210, "detail": "" }
]
}
overall is "ok" / "degraded" / "down". HTTP 200 / 207 / 503.
Wikidata SPARQL
query_wikidata runs SPARQL queries against Wikidata for biographical and historical F1 facts not covered by race APIs.
Only SELECT and ASK queries are accepted (read-only). Always include LIMIT in your query.
Example — find F1 drivers with their birthdate:
SELECT ?driver ?driverLabel ?birthDate WHERE {
?driver wdt:P31 wd:Q5 ;
wdt:P641 wd:Q1968 ;
wdt:P569 ?birthDate .
SERVICE wikibase:label { bd:serviceParam wikibase:language "en" }
} ORDER BY DESC(?birthDate) LIMIT 10
Pagination
All list-returning tools accept page (1-based, default 1) and page_size (defaults vary per tool: 10–50). Responses include a pagination block:
{
"data": [...],
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 47,
"total_pages": 3,
"has_next": true,
"has_prev": false
}
}
Configuration
| Variable | Default | Description |
|---|---|---|
PITSTOP_TRANSPORT |
http |
http or stdio |
PITSTOP_HOST |
0.0.0.0 |
Bind address (HTTP only) |
PITSTOP_PORT |
8000 |
Listen port (HTTP only) |
PITSTOP_ENV |
development |
development or production |
PITSTOP_LOG_LEVEL |
Depends on PITSTOP_ENV |
DEBUG if development, else INFO |
PITSTOP_LOG_FORMAT |
Depends on PITSTOP_ENV |
text if development, else json |
PITSTOP_ENABLE_CACHING |
true |
Enable HTTP response and FastF1 disk caching |
PITSTOP_CACHE_TTL_SECONDS |
300 |
HTTP response cache time-to-live (seconds) |
PITSTOP_RATE_LIMIT_ENABLED |
false |
Enable concurrent-call limiting |
PITSTOP_RATE_LIMIT_PER_HOUR |
3600 |
Max concurrent calls (derived from per-hour quota) |
FASTF1_CACHE |
cache |
FastF1 cache directory path |
Caching
Pitstop uses in-memory HTTP response caching (via Hishel) for GET requests with 200 responses. This keeps tool calls inside upstream rate limits:
- Jolpica: 4 req/s, 500/hr
- OpenF1: 3 req/s, 30/min
- Wikidata: Query complexity limits
- RSS: Per-feed redirects cached
FastF1 maintains its own disk cache in FASTF1_CACHE directory. Control caching via:
PITSTOP_ENABLE_CACHING=true(default)PITSTOP_CACHE_TTL_SECONDS=300(default)
Development
uv sync --dev
uv run pytest
uv run ruff check src/
Contributing
See CONTRIBUTING.md.
Credits & attribution
| Source | Description | License |
|---|---|---|
| F1DB | Database seeded from F1DB and subsequently modified & extended by pitstop | CC BY 4.0 |
| FastF1 | Python library for F1 timing, telemetry, and session data | MIT |
| Jolpica-F1 | Ergast-compatible F1 data API, 1950–present; also used to self-update the F1DB-seeded database weekly | — |
| OpenF1 | Free open-source API for real-time F1 data | MIT |
| Wikidata | Open knowledge graph with SPARQL query service | CC0 |
| Ergast Motor Racing API | Historical F1 data 1950–2024 (now served via Jolpica) | — |
| RSS Feeds (20 sources) | News headlines, credited collectively; see each feed's link field in get_f1_news results |
Respective publishers |
Not affiliated with Formula 1 or the FIA. Data provided by third-party sources under their respective terms.
Pitstop MCPのよくある質問
Pitstop MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' pitstop -- uvx pitstop-f1を実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Pitstop MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Pitstop MCPが提供するツールは
11個のツールを提供しており、get_session_data, get_telemetry_data, get_live_data, get_standings, get_scheduleなどがあります。
Pitstopをローカルにインストールするにはどうすればよいですか?
PITSTOP_TRANSPORT=stdio uvx pitstop-f1 を実行することで、stdio経由でインストールできます。
Pitstopはリアルタイムデータを提供していますか?
はい、get_live_dataツールを通じて、ライブのインターバル、ピットストップ、チーム無線、レースコントロールのデータを提供します。
F1の履歴についてSPARQLクエリを実行できますか?
はい、query_wikidataツールを使用すると、Wikidataに対して読み取り専用のSELECTおよびASK SPARQLクエリを実行し、経歴や歴史的事実を取得できます。