Skip to content
Back to search

gt7-mcp

MCP server that lets an agent drive GT7 under RyGT/shadGT: launch, screenshots, pad input, logs, telemetry driver

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rygt-team--gt7-mcp/badge.svg)](/listings/rygt-team--gt7-mcp)

HTML

<a href="/listings/rygt-team--gt7-mcp"><img src="/api/listings/rygt-team--gt7-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- Windows, Python 3.10+, `pip install pillow`. - The game folder is `GT7_ROOT`; by default it's `GTSport-Ryty-shadGT-2026-10-16-4` next to this repository's folder. `GT7_LAUNCH` overrides the launch script. - Register the server in `.mcp.json`:

{
  "mcpServers": {
    "gt7": {
      "type": "stdio",
      "command": "python",
      "args": ["-I", "<path>\\gt7-mcp\\server.py"],
      "env": { "GT7_ROOT": "<path>\\GTSport-Ryty-shadGT-2026-10-16-4" }
    }
  }
}

- `python try_client.py gt7_status gt7_screenshot` talks to the server as a client would and saves screenshots as `shot-N.jpg`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 58 lines
  1. # gt7-mcp
  2. A small MCP server (stdio JSON-RPC, Python, only Pillow needed) that lets an agent drive GT7 running under RyGT /
  3. shadGT on Windows. It launches the game with the RyGT launcher's settings, looks at the window, presses pad buttons,
  4. and reads the game's logs. It was built for performance work: getting into the same race repeatably while
  5. PresentMon and Nsight capture.
  6. ## Tools
  7. | Tool | What it does |
  8. |---|---|
  9. | `gt7_launch` | Starts `GT7.exe` through `launch/gt7-direct.ps1` (PS4 Pro mode, 1080p, in-place ranges). `switches` adds environment variables, e.g. `{"SHADGT_HAPTICS_LOG": "6"}`. |
  10. | `gt7_close` | Closes GT7: asks first, then forces it after 10 s. |
  11. | `gt7_status` | Whether GT7 is running, whether its window is in front, and the last race-state line (`GAME-002` / `GAME-006`). |
  12. | `gt7_screenshot` | A JPEG of the game window. |
  13. | `gt7_clip` | 2-12 frames over time, tiled into one image. |
  14. | `gt7_stream` | A live MJPEG view at `http://127.0.0.1:PORT/` (localhost only). |
  15. | `gt7_press` | Pad buttons: cross, circle, triangle, square, options, D-pad, l1/r1, l2 (brake), r2 (throttle), l3/r3, touchpad, steer_left/right, stick_up/down. They're sent as the keyboard keys `user\input_config\default.ini` binds to them, held together, with `hold_ms` up to 30 s. |
  16. | `gt7_log` | Lines of `stderr.log` / `stdout.log`, optionally filtered by a regex. |
  17. ## Setup
  18. - Windows, Python 3.10+, `pip install pillow`.
  19. - The game folder is `GT7_ROOT`; by default it's `GTSport-Ryty-shadGT-2026-10-16-4` next to this repository's folder.
  20. `GT7_LAUNCH` overrides the launch script.
  21. - Register the server in `.mcp.json`:
  22. ```json
  23. {
  24. "mcpServers": {
  25. "gt7": {
  26. "type": "stdio",
  27. "command": "python",
  28. "args": ["-I", "<path>\\gt7-mcp\\server.py"],
  29. "env": { "GT7_ROOT": "<path>\\GTSport-Ryty-shadGT-2026-10-16-4" }
  30. }
  31. }
  32. }
  33. ```
  34. - `python try_client.py gt7_status gt7_screenshot` talks to the server as a client would and saves screenshots as
  35. `shot-N.jpg`.
  36. ## Notes for agents
  37. - **Menus:** press a button, then take a screenshot. The game sometimes misses the first press after a load, so
  38. repeat it if the screen didn't change.
  39. - **Racing:** the test car is a manual (MT). Cross shifts up and square shifts down; holding only r2 leaves it on
  40. the limiter.
  41. - **Steering:** the race lobby's gear icon → Assistance Settings → Auto-Drive = "Brake & Steering" lets the game
  42. steer and brake. Auto-Drive is a saved setting, so set it back to Off afterwards.
  43. - **Driving by telemetry:** start GT7 with `SHADGT_HAPTICS_LOG=6`. The renderer then logs GT7's telemetry (speed,
  44. rpm, gear, wall contact; position and heading in DIAG-SGT-050 builds) to `stderr.log` about 10 times a second.
  45. `tools/gt7-drive.py SECONDS --out TRACE --log LOG` holds the throttle, shifts by rpm and records the path. It runs
  46. as one local loop, because round trips through `gt7_press` drop the throttle between calls. `--ref TRACE`
  47. (steering along a recorded path) is untested.
  48. - **Captures:** when nsys records GPU metrics, its console window pops up over the game. Measure fps with
  49. PresentMon on its own first.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.