Skip to main content

MCP server for motorsports telemetry coaching — session analysis, day reviews, and driving KPIs

Project description

inferno-driving-coach

MCP server for motorsports telemetry coaching. Analyzes AIM (XRK/XRZ) and iRacing (IBT) telemetry data to produce structured session reports with corner consistency analysis, braking analysis, G utilization, and actionable improvement areas.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "inferno-driving-coach": {
      "command": "uvx",
      "args": ["inferno-driving-coach"]
    }
  }
}

Claude Code

Add to your project or global settings:

{
  "mcpServers": {
    "inferno-driving-coach": {
      "command": "uvx",
      "args": ["inferno-driving-coach"]
    }
  }
}

Tools

analyze_session

Run full session analysis on telemetry files. Produces a structured report with:

  • Lap times and consistency metrics
  • Corner-by-corner consistency analysis (braking, apex speed, exit speed, throttle acceptance)
  • G utilization and "G hole" detection
  • Braking balance analysis
  • Suspension velocity histograms
  • Tire grip and condition data
  • Track map and corner comparison images

Accepts multiple files from the same session (e.g., split by a car restart) and merges them automatically.

group_sessions

Detect and group split session files into logical sessions. AIM loggers create a new file when the car is restarted — this tool detects those splits by comparing metadata timestamps and groups files that belong together.

list_profiles

List available vehicle profiles and their channel name mappings. Profiles map canonical channel names (like "throttle", "brake", "gps_speed") to the actual AIM channel names for each vehicle/logger combination.

Prompts

session_analysis

Full coaching workflow: analyzes a session, identifies the top 3 improvement areas, shows best execution with root cause analysis, sets KPIs, and generates a markdown report with track map and comparison images.

session_day_review

Multi-session workflow: discovers all telemetry files in a directory, groups split sessions, analyzes each session sequentially with cross-session KPI tracking, and generates a day summary with progression analysis.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

inferno_driving_coach-0.13.1.tar.gz (99.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

inferno_driving_coach-0.13.1-py3-none-any.whl (112.3 kB view details)

Uploaded Python 3

File details

Details for the file inferno_driving_coach-0.13.1.tar.gz.

File metadata

  • Download URL: inferno_driving_coach-0.13.1.tar.gz
  • Upload date:
  • Size: 99.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for inferno_driving_coach-0.13.1.tar.gz
Algorithm Hash digest
SHA256 d739969371a96685151647d4bd67325298e6d832f8ff2f0148ec0114f9555683
MD5 b79ec6feb55013e83ae18fa815f4ed82
BLAKE2b-256 a29bbd852b146f24998e98fa81bfa8d505549e2c3c7a00f2bbd4e5da3e0fbe46

See more details on using hashes here.

File details

Details for the file inferno_driving_coach-0.13.1-py3-none-any.whl.

File metadata

  • Download URL: inferno_driving_coach-0.13.1-py3-none-any.whl
  • Upload date:
  • Size: 112.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for inferno_driving_coach-0.13.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cf799cf603d30c2d162970de9ea22f60c0a39b80ee2412ecf2ba09ac80abe639
MD5 572f4eda1651e8b7c2196ca7fb33fbfc
BLAKE2b-256 72c59c40e972d2c956fc99664e61abbd1e920782a99ffa3aeb57ce8b5569e130

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page