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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

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

inferno_driving_coach-0.17.2-py3-none-any.whl (174.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: inferno_driving_coach-0.17.2-py3-none-any.whl
  • Upload date:
  • Size: 174.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","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.17.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2f534d54f5c98afb28d553db7f5ec7565057370b4f999bae2b7bebbd0527ab2c
MD5 af2e29b1617028032b9320079c8269c1
BLAKE2b-256 88dfa5dad039b2aa16fea731c6e3cf75920cee52153c7add35b3aadb853f7cf6

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