关键词

iRacing辅助赛车AI教练实时遥测驾驶分析车况监测

项目简介

Race MCP是一款基于Model Context Protocol (MCP) 构建的服务器应用，专为iRacing模拟赛车游戏设计。它能实时处理游戏遥测数据，提供AI驱动的驾驶建议、车况监测、圈速分析及赛道信息交互，帮助车手提升表现。

主要功能点

  • 实时遥测处理: 从iRacing获取实时数据，并进行高级分析，如G力计算、赛车线评估、档位优化等。
  • AI驾驶教练: 根据驾驶模式和赛道情况提供个性化指导和改进建议。
  • 智能车况观察: 监测附近车辆位置、速度和预测轨迹，增强赛道意识。
  • 详细圈速分析: 提供分段计时、赛车线效率、一致性评级和具体改进区域。
  • 会话跟踪: 监控长期性能趋势、统计数据、燃油使用和轮胎磨损。
  • 对话式交互: 支持与AI进行自然语言交流，获取赛车数据和建议。

安装步骤

  1. 克隆仓库: 
    git clone https://github.com/consolecowboy0/race-mcp
cd race-mcp
  2. 创建并激活虚拟环境: 
    python -m venv .venv
source .venv/bin/activate  # 在 Windows 系统上: .venv\Scripts\activate
  3. 安装依赖: 
    pip install -e .
# 或者手动安装核心依赖:
# pip install mcp pyirsdk pydantic aiofiles
    (可选：如果需要语音交互功能，请额外安装 'pip install race-mcp-server[voice]' 并确保已设置 'OPENAI_API_KEY' 环境变量。)

服务器配置 (MCP客户端使用)

MCP客户端需要以下信息来连接到Race MCP服务器。这些信息通常以JSON格式提供给客户端，以便它知道如何启动和连接服务器。

{
  "server_name": "race-mcp-server",
  "command": "python",
  "args": ["-m", "race_mcp_server"],
  "description": "提供iRacing遥测数据分析和AI教练的MCP服务器"
}

参数注释:

  • 'server_name': MCP服务器的唯一标识符。
  • 'command': 用于启动MCP服务器进程的可执行程序，此处为Python解释器。
  • 'args': 传递给 'command' 的参数列表。'"-m", "race_mcp_server"' 表示以模块方式运行 'race_mcp_server' 包。
  • 'description': 服务器功能的简要描述。

额外提示:

  • 如需调试日志，可在 'args' 中添加 '--debug'。
  • 如需在没有iRacing模拟器的情况下运行（将使用模拟数据），可在 'args' 中添加 '--simulation'。
  • 如果想连接到独立的Mock iRacing 数据流（而非内置模拟），请在启动服务器前设置环境变量 'USE_MOCK_TELEMETRY=true'，并确保 Mock 流服务器已运行：'python -m race_mcp_server.mock_iracing_stream --port 9000'。

基本使用方法

  1. 激活虚拟环境 (如果尚未激活)。
  2. 启动MCP服务器: 
    python -m race_mcp_server
# 或者使用快捷脚本:
# ./start_server.sh
# 或者通过GUI启动:
# race-mcp-gui
  3. 连接MCP客户端: 使用上述服务器配置信息，通过兼容MCP协议的客户端（如LLM应用）连接到该服务器，即可利用其提供的工具、资源和Prompt功能。
  4. 运行测试客户端: 验证服务器功能是否正常。 
    python test_client.py
# 或者使用快捷脚本进行自动化测试:
# ./start_server.sh --test

信息

分类

AI与计算

访问项目