赛车遥测数据服务器

iRacing MCP服务器提供实时遥测数据、排行榜信息、摄像头控制、维修站命令和回放功能,适用于AI助手和其他需要访问iRacing数据的应用。

  • by ellettie
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ellettie/iracing-mcp-server

使用说明

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许可证下发布。

致谢