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.14.0.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.14.0-py3-none-any.whl (112.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: inferno_driving_coach-0.14.0.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.14.0.tar.gz
Algorithm Hash digest
SHA256 8b291d1205d748505e49820bb0862254097411af84704a014e8dee725e720d6d
MD5 2ffc11f46bfbd61a851f64552e549043
BLAKE2b-256 dff1c21051bc11f9a7fa58b7cf7cd30f633db1bce57ab28cad9f7f639b6eeb7d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: inferno_driving_coach-0.14.0-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.14.0-py3-none-any.whl
Algorithm Hash digest
SHA256 58e059b887ab9e100a2fbd10d1c05c94ed3691d49d84f28cfb5c0f5185d88c30
MD5 b9d554ee3a1515bee7e00e8d932bf8fd
BLAKE2b-256 0b4d05cd52bf1acebeed477da59f5014f9c79541c1948323a033ff876cf49d55

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