使用说明
iRacing MCP服务器
用于访问iRacing遥测数据和游戏功能的MCP(模型上下文协议)服务器。
概述
该项目通过MCP协议从iRacing提供实时遥测数据、排行榜信息、摄像头控制、坑命令、回放功能等。它使AI助手和其他应用程序能够轻松访问iRacing数据。
主要特点
📊 遥测数据
- 检索实时遥测值
- 获取可用遥测变量列表
🏁 竞赛规程
- 获取排行榜(仅限竞争职位)
- 访问驾驶员信息、会话信息、周末信息和分段时间信息
- 监控当前标志和发动机警告
📹 相机控制
- 获取可用的相机组
- 切换摄像头(按车号、位置、组规格)
- 检查当前摄像头状态
🔧 矿坑作业
- 检查矿坑服务状态
- 执行维修站命令(加油、更换轮胎、维修等)
- 管理安全矿坑作业
🎬 重播功能
- 搜索和导航回放
- 在会话、圈和帧之间移动
- 跳转到事件标记
需求
- Python 3.13或更高版本
- iRacing(必须正在运行)
- 紫外线
用法
1.配置mcp.json
{
"mcpServers": {
"iracing-mcp-server": {
"command": "uvx",
"args":["iracing-mcp-server"]
}
}
}
可用工具
遥测相关
get_telemetry_names()-获取可用遥测变量get_telemetry_values(names)-获取指定的遥测值
竞赛规程
get_leaderboard()-获取排行榜get_driver_info()-获取驾驶员信息get_session_info()-获取会话信息get_qualify_results_info()-获取资格认证结果信息get_weekend_info()-获取周末信息get_split_time_info()-获取分段时间信息get_radio_info()-获取无线电信息get_current_flags()-获取当前标志get_current_engine_warnings()-获取发动机警告
相机控制
get_camera_info()-获取摄像头信息get_current_camera_status()-获取当前摄像头状态cam_switch(group_number, car_number_raw, position)-切换摄像头
矿坑作业
get_current_pit_service_status()-获取当前维修站服务状态pit_command(commands_and_values)-执行坑命令
重播功能
replay_search(search_commands)-搜索和导航回放
发展
依赖项
mcp[cli]>=1.12.2-MCP协议实现pyirsdk>=1.3.5-iRacing SDK Python绑定
项目结构
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
许可证
该项目在MIT许可证下发布。