{"id":31684552,"url":"https://github.com/praneethravuri/pitstop","last_synced_at":"2026-05-15T22:03:25.405Z","repository":{"id":318056493,"uuid":"1069811851","full_name":"praneethravuri/pitstop","owner":"praneethravuri","description":"🏎️ Your pit stop for all things F1 - MCP server delivering championship standings, race analytics, and telemetry data straight to your AI assistant","archived":false,"fork":false,"pushed_at":"2025-10-04T20:27:45.000Z","size":167,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-04T20:38:55.088Z","etag":null,"topics":["agentic-ai","ai","ai-agent","claude","f1","formula1","mcp","mcp-server","motorsport","python","racing","telemetry"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/praneethravuri.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-04T17:07:26.000Z","updated_at":"2025-10-04T20:27:49.000Z","dependencies_parsed_at":"2025-10-04T20:39:00.953Z","dependency_job_id":"0adba47f-5d04-4315-adda-19ccc76904ee","html_url":"https://github.com/praneethravuri/pitstop","commit_stats":null,"previous_names":["praneethravuri/pitstop"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/praneethravuri/pitstop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/praneethravuri%2Fpitstop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/praneethravuri%2Fpitstop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/praneethravuri%2Fpitstop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/praneethravuri%2Fpitstop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/praneethravuri","download_url":"https://codeload.github.com/praneethravuri/pitstop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/praneethravuri%2Fpitstop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278909749,"owners_count":26066898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","ai","ai-agent","claude","f1","formula1","mcp","mcp-server","motorsport","python","racing","telemetry"],"created_at":"2025-10-08T08:09:53.851Z","updated_at":"2026-05-15T22:03:25.398Z","avatar_url":"https://github.com/praneethravuri.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏎️ Pitstop: The All-in-One F1 MCP Server\n\nPitstop is a comprehensive Model Context Protocol (MCP) server for Formula 1 data. It aggregates data from multiple authoritative sources to answer any F1-related question, from historical stats to real-time race telemetry.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://media.formula1.com/image/upload/f_auto,c_limit,w_1440,q_auto/f_auto/q_auto/content/dam/fom-website/manual/Misc/2021-Master-Folder/F1%20Logo%202021%20-%20Red\" width=\"200\" alt=\"F1 Logo\" /\u003e\n\u003c/div\u003e\n\n## 🌟 Capabilities\n\nPitstop consolidates specialized functions into **7 powerful tools**:\n\n1.  **`get_live_data`**: Real-time access to telemetry, pit stops, team radio, race control messages, and intervals.\n2.  **`get_session_data`**: Comprehensive session analysis including results, weather, fastest laps, and driver details.\n3.  **`get_telemetry_data`**: Deep dive into car performance with lap-by-lap telemetry (speed, throttle, brake, gears).\n4.  **`get_reference_data`**: Static encyclopedia for drivers, teams, circuits, and tire compounds.\n5.  **`get_standings`**: Current and historical championship standings.\n6.  **`get_schedule`**: Full calendar awareness including testing and future races.\n7.  **`get_f1_news`**: Latest headlines from 25+ trusted global sources.\n\n## 🔌 Data Sources\n\n-   **OpenF1 API**: Real-time timing \u0026 telemetry (2023-Present)\n-   **FastF1 / Ergast**: Historical data \u0026 deep analysis (1950-Present)\n-   **RSS Feeds**: Aggregated news from official and major media outlets.\n\n## 🚀 Installation \u0026 Usage\n\n### Prerequisites\n-   Python 3.13+\n-   `uv` (recommended) or `pip`\n\n### 1. Install via Smithery (Recommended)\n\nTo install Pitstop for Claude Desktop automatically:\n\n```bash\nnpx -y @smithery/cli install pitstop --client claude\n```\n\n### 2. Manual Installation\n\nClone the repository and install dependencies:\n\n```bash\ngit clone https://github.com/praneethravuri/pitstop.git\ncd pitstop\nuv sync\n```\n\n### 3. Running the Server\n\nRun the MCP server directly using `uv`:\n\n```bash\nuv run pitstop\n```\n\n### 4. Docker Deployment\n\nTo run with Docker Compose:\n\n### 5. Client Configuration\n\nTo use Pitstop with MCP clients like Antigravity, Claude Desktop, or Claude Code, add the following to your configuration file (e.g., `claude_desktop_config.json` or `mcp.json`).\n\n#### Option A: Docker (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"pitstop\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"pitstop\"],\n      \"env\": {\n        \"PITSTOP_ENV\": \"production\"\n      }\n    }\n  }\n}\n```\n\n#### Option B: Local (`uv`)\n\n```json\n{\n  \"mcpServers\": {\n    \"pitstop\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"run\",\n        \"--directory\",\n        \"/absolute/path/to/pitstop\", \n        \"pitstop\"\n      ],\n      \"env\": {\n        \"PITSTOP_ENV\": \"production\"\n      }\n    }\n  }\n}\n```\n\n\u003e **Note**: Replace `/absolute/path/to/pitstop` with the actual path to your cloned repository.\n\nOr manually using python:\n\n```bash\n# Add src to PYTHONPATH if running manually\nexport PYTHONPATH=$PYTHONPATH:$(pwd)/src\npython -m pitstop\n```\n\n## 🛠️ Tool Usage Guide\n\n| Tool | Purpose | Example Query |\n| :--- | :--- | :--- |\n| **`get_live_data`** | Live race monitoring | \"Check the gap between VER and HAM\", \"Any specialized pit stops?\" |\n| **`get_session_data`** | Post-session analysis | \"Get full results for Monaco 2024\", \"What was the weather during Q3?\" |\n| **`get_standings`** | Championship tracker | \"Who is leading the constructor standings?\", \"2021 driver points\" |\n| **`get_schedule`** | Calendar \u0026 Events | \"When is the next race?\", \"Monaco GP start times\" |\n| **`get_reference_data`** | Encyclopedia | \"How many corners does Spa have?\", \"Max Verstappen stats\" |\n| **`get_f1_news`** | News Aggregator | \"Latest Ferrari news\", \"Updates on Newey\" |\n| **`get_telemetry_data`** | Deep Tech Analysis | \"Compare telemetry for VER and LEC in Q3\" |\n\n## 📦 Project Structure\n\n```\nsrc/\n  pitstop/\n    __main__.py       # Entry point\n    clients/          # API Clients (OpenF1, FastF1, RSS)\n    models/           # Pydantic Data Models\n    tools/            # Tool Implementations\n      live/           # Live Data Tools\n      general/        # Session \u0026 Telemetry\n      reference/      # Static Data\n      ...\n```\n\n## 📜 License\n\nMIT License. Data provided by FastF1, OpenF1, and Ergast. Not affiliated with Formula 1 or FIA.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpraneethravuri%2Fpitstop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpraneethravuri%2Fpitstop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpraneethravuri%2Fpitstop/lists"}