11개의 전문 도구를 통해 AI 클라이언트에게 Formula 1의 실시간, 과거 및 뉴스 데이터를 제공합니다.
다른 이름 praneethravuri/pitstop, pitstop-f1
- 스타
- 1
- Tools
- 11
- 다운로드, 30일
- 65
- 최신 버전
- 0.5.0
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- MIT
Pitstop MCP란?
11개의 전문 도구를 통해 AI 클라이언트에게 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드라이버 퍼포먼스 분석특정 Grand Prix 기간 동안 드라이버의 페이스, 타이어 마모 및 스틴트 일관성에 대한 상세 분석을 요청합니다.
- 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Pitstop MCP는 어떤 도구를 제공하나요?
11개 도구를 제공합니다. 예: get_session_data, get_telemetry_data, get_live_data, get_standings, get_schedule.
Pitstop을 로컬에 어떻게 설치하나요?
PITSTOP_TRANSPORT=stdio uvx pitstop-f1 명령어를 실행하여 stdio를 통해 uvx로 설치할 수 있습니다.
Pitstop은 실시간 데이터를 제공하나요?
네, get_live_data 도구를 통해 라이브 인터벌, 피트 스톱, 팀 라디오 및 레이스 컨트롤 데이터를 제공합니다.
F1 역사를 위해 SPARQL 쿼리를 실행할 수 있나요?
네, query_wikidata 도구를 사용하여 Wikidata에서 인물 정보 및 역사적 사실에 대한 읽기 전용 SELECT 및 ASK SPARQL 쿼리를 실행할 수 있습니다.