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

Uploaded Python 3

File details

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

File metadata

  • Download URL: inferno_driving_coach-0.17.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5a7c8240d745ff44c55fe7865e69f33c7986111d563a11109ff78ac432e484d7
MD5 7fc656b5285d1ec342ba6fcd2ce2f692
BLAKE2b-256 7c43acc4769a69e05c2774936d2d64f37e34cc808fd5fdc56f361a8e4c889931

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