| Name | iracing-mcp-server JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | MCP server for iRacing |
| upload_time | 2025-07-27 15:09:41 |
| maintainer | None |
| docs_url | None |
| author | ellettie |
| requires_python | >=3.13 |
| license | MIT License Copyright (c) 2025 Toshihiro Kawasaki Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
mcp
mcp-server
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# iRacing MCP Server
An MCP (Model Context Protocol) server for accessing iRacing telemetry data and game functionality.
## Overview
This project provides real-time telemetry data, leaderboard information, camera control, pit commands, replay functionality, and more from iRacing through the MCP protocol. It enables AI assistants and other applications to easily access iRacing data.
## Key Features
### 📊 Telemetry Data
- Retrieve real-time telemetry values
- Get list of available telemetry variables
### 🏁 Race Information
- Get leaderboard (competitive positions only)
- Access driver information, session information, weekend information, and split time information
- Monitor current flags and engine warnings
### 📹 Camera Control
- Get available camera groups
- Switch cameras (by car number, position, group specification)
- Check current camera status
### 🔧 Pit Operations
- Check pit service status
- Execute pit commands (refueling, tire changes, repairs, etc.)
- Manage safe pit operations
### 🎬 Replay Features
- Search and navigate replays
- Move between sessions, laps, and frames
- Jump to incident markers
## Requirements
- Python 3.13 or higher
- iRacing (must be running)
- uv
## Usage
### 1. Configure mcp.json
```json
{
"mcpServers": {
"iracing-mcp-server": {
"command": "uvx",
"args":["iracing-mcp-server"]
}
}
}
```
## Available Tools
### Telemetry Related
- `get_telemetry_names()` - Get available telemetry variables
- `get_telemetry_values(names)` - Get specified telemetry values
### Race Information
- `get_leaderboard()` - Get leaderboard
- `get_driver_info()` - Get driver information
- `get_session_info()` - Get session information
- `get_qualify_results_info()` - Get qualification results information
- `get_weekend_info()` - Get weekend information
- `get_split_time_info()` - Get split time information
- `get_radio_info()` - Get radio infomation
- `get_current_flags()` - Get current flags
- `get_current_engine_warnings()` - Get engine warnings
### Camera Control
- `get_camera_info()` - Get camera information
- `get_current_camera_status()` - Get current camera status
- `cam_switch(group_number, car_number_raw, position)` - Switch camera
### Pit Operations
- `get_current_pit_service_status()` - Get current pit service status
- `pit_command(commands_and_values)` - Execute pit command
### Replay Features
- `replay_search(search_commands)` - Search and navigate replay
## Development
### Dependencies
- `mcp[cli]>=1.12.2` - MCP protocol implementation
- `pyirsdk>=1.3.5` - iRacing SDK Python bindings
### Project Structure
```
iracing-mcp-server/
├── src/iracing_mcp_server/
│ ├── __init__.py # Main entry point
│ ├── server.py # MCP server implementation
│ ├── leaderboard.py # Leaderboard processing
│ └── prompt.py # Prompt templates
├── pyproject.toml # Project configuration
└── README.md # This file
```
## License
This project is released under the MIT License.
## Acknowledgments
- [pyirsdk](https://github.com/kutu/pyirsdk) - Python bindings for iRacing SDK
- [MCP](https://modelcontextprotocol.io/) - Model Context Protocol
Raw data
{
"_id": null,
"home_page": null,
"name": "iracing-mcp-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "mcp, mcp-server",
"author": "ellettie",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/a0/0e/80f3c7bf959fda5225a6eb53f2b7efa6b53bb5d17713904b38d912828ef4/iracing_mcp_server-0.1.1.tar.gz",
"platform": null,
"description": "# iRacing MCP Server\n\nAn MCP (Model Context Protocol) server for accessing iRacing telemetry data and game functionality.\n\n## Overview\n\nThis project provides real-time telemetry data, leaderboard information, camera control, pit commands, replay functionality, and more from iRacing through the MCP protocol. It enables AI assistants and other applications to easily access iRacing data.\n\n## Key Features\n\n### \ud83d\udcca Telemetry Data\n- Retrieve real-time telemetry values\n- Get list of available telemetry variables\n\n### \ud83c\udfc1 Race Information\n- Get leaderboard (competitive positions only)\n- Access driver information, session information, weekend information, and split time information\n- Monitor current flags and engine warnings\n\n### \ud83d\udcf9 Camera Control\n- Get available camera groups\n- Switch cameras (by car number, position, group specification)\n- Check current camera status\n\n### \ud83d\udd27 Pit Operations\n- Check pit service status\n- Execute pit commands (refueling, tire changes, repairs, etc.)\n- Manage safe pit operations\n\n### \ud83c\udfac Replay Features\n- Search and navigate replays\n- Move between sessions, laps, and frames\n- Jump to incident markers\n\n## Requirements\n\n- Python 3.13 or higher\n- iRacing (must be running)\n- uv\n\n## Usage\n\n### 1. Configure mcp.json\n```json\n{\n \"mcpServers\": {\n \"iracing-mcp-server\": {\n \"command\": \"uvx\",\n \"args\":[\"iracing-mcp-server\"]\n }\n }\n}\n```\n\n## Available Tools\n\n### Telemetry Related\n- `get_telemetry_names()` - Get available telemetry variables\n- `get_telemetry_values(names)` - Get specified telemetry values\n\n### Race Information\n- `get_leaderboard()` - Get leaderboard\n- `get_driver_info()` - Get driver information\n- `get_session_info()` - Get session information\n- `get_qualify_results_info()` - Get qualification results information\n- `get_weekend_info()` - Get weekend information\n- `get_split_time_info()` - Get split time information\n- `get_radio_info()` - Get radio infomation\n- `get_current_flags()` - Get current flags\n- `get_current_engine_warnings()` - Get engine warnings\n\n### Camera Control\n- `get_camera_info()` - Get camera information\n- `get_current_camera_status()` - Get current camera status\n- `cam_switch(group_number, car_number_raw, position)` - Switch camera\n\n### Pit Operations\n- `get_current_pit_service_status()` - Get current pit service status\n- `pit_command(commands_and_values)` - Execute pit command\n\n### Replay Features\n- `replay_search(search_commands)` - Search and navigate replay\n\n## Development\n\n### Dependencies\n- `mcp[cli]>=1.12.2` - MCP protocol implementation\n- `pyirsdk>=1.3.5` - iRacing SDK Python bindings\n\n### Project Structure\n```\niracing-mcp-server/\n\u251c\u2500\u2500 src/iracing_mcp_server/\n\u2502 \u251c\u2500\u2500 __init__.py # Main entry point\n\u2502 \u251c\u2500\u2500 server.py # MCP server implementation\n\u2502 \u251c\u2500\u2500 leaderboard.py # Leaderboard processing\n\u2502 \u2514\u2500\u2500 prompt.py # Prompt templates\n\u251c\u2500\u2500 pyproject.toml # Project configuration\n\u2514\u2500\u2500 README.md # This file\n```\n\n## License\n\nThis project is released under the MIT License.\n\n## Acknowledgments\n\n- [pyirsdk](https://github.com/kutu/pyirsdk) - Python bindings for iRacing SDK\n- [MCP](https://modelcontextprotocol.io/) - Model Context Protocol\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2025 Toshihiro Kawasaki Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "MCP server for iRacing",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/ellettie/iracing-mcp-server",
"Repository": "https://github.com/ellettie/iracing-mcp-server"
},
"split_keywords": [
"mcp",
" mcp-server"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "370bf7afcd91bcc05c9d60b865f095bc59119c96839eaa842d68d975b3625649",
"md5": "2880d25d7904e2b0ff53648f5afe1a90",
"sha256": "705322e640ff5f820d7702261c25543ae25acc43b59b6e010d8568cf9454db56"
},
"downloads": -1,
"filename": "iracing_mcp_server-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2880d25d7904e2b0ff53648f5afe1a90",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 12757,
"upload_time": "2025-07-27T15:09:40",
"upload_time_iso_8601": "2025-07-27T15:09:40.173877Z",
"url": "https://files.pythonhosted.org/packages/37/0b/f7afcd91bcc05c9d60b865f095bc59119c96839eaa842d68d975b3625649/iracing_mcp_server-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a00e80f3c7bf959fda5225a6eb53f2b7efa6b53bb5d17713904b38d912828ef4",
"md5": "ebdeccf58ca2a0b3e974a34fb05ba86a",
"sha256": "1e49b6289481c2f37bb458c13c02b3ce2b7415babe49d17d2e980460afcff441"
},
"downloads": -1,
"filename": "iracing_mcp_server-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "ebdeccf58ca2a0b3e974a34fb05ba86a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 29704,
"upload_time": "2025-07-27T15:09:41",
"upload_time_iso_8601": "2025-07-27T15:09:41.076584Z",
"url": "https://files.pythonhosted.org/packages/a0/0e/80f3c7bf959fda5225a6eb53f2b7efa6b53bb5d17713904b38d912828ef4/iracing_mcp_server-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-27 15:09:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ellettie",
"github_project": "iracing-mcp-server",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "iracing-mcp-server"
}
