iRacing 🐎

iRacing Data MCP 服务 🏎️

一个 Node.js 模型上下文协议（MCP）服务，可无缝访问 iRacing 的赛车模拟数据 API。本项目既可作为独立的命令行工具，也可作为 MCP 服务集成 AI 助手。

🌟 功能

🤖 MCP 服务集成

• 适用于 AI 助手：可无缝集成 Claude、ChatGPT 及其他 AI 助手
• 实时数据访问：实时访问 iRacing 的全面赛车数据
• 自动身份验证：自动处理登录和会话管理
• 类型安全的操作：全面支持 TypeScript，并使用 Zod 进行架构验证

📊 数据访问

• 会员资料：详细的车手信息，包括执照和评级
• 车队信息：全面的车队数据和统计信息
• 生涯统计：完整的赛车生涯历史和成就
• 赛季回顾：详细的赛季表现和进展
• 车手查找：按姓名搜索和查找车手
• API 文档：内置访问 iRacing API 文档的功能

🛠️ 双重界面

• MCP 服务：用于集成 AI 助手
• 命令行工具：用于直接通过命令行访问和自动化

📖 用法

作为 MCP 服务

LLM 客户端配置

要将此 MCP 服务与 Claude Desktop 等 AI 助手搭配使用，请将以下配置添加到 MCP 设置文件中： Claude Desktop 配置（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "iracing-data-mcp-server": {
      "command": "npx",
      "args": [
        "iracing-data-mcp-server@latest",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/cookie-jar-file"
      ]
      "env": {
        "COOKIE_JAR": "/path/to/your/cookie-jar-file",
        "EMAIL": "[email protected]",
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

可用的 MCP 工具

服务启动后，将向 AI 助手提供以下工具：

工具	描述	参数
login	使用 iRacing 进行身份验证	无
get_members_profile	获取会员资料数据	member_ids: number[]
get_team	获取车队信息	team_id: string
get_member_recap	获取赛季回顾数据	member_id: number、year?: number、season?: number
get_member_career	获取生涯统计数据	member_id: number
driver_lookup	搜索车手	driver_name: string

📹 观看视频

作为 CLI 工具

环境设置

在项目目录中创建 .env 文件：

# Required: Path to store authentication cookies
COOKIE_JAR=./cookies.txt

# Required: Your iRacing account credentials
[email protected]

# Option 1: Use your iRacing password
PASSWORD=your_password

# Option 2: Use pre-generated API key (recommended for security)
# API_KEY=your_api_key_here

初次身份验证

使用 CLI 前，请先通过 iRacing 进行身份验证：

npm run login

使用命令行界面直接访问数据：

获取会员资料

# Single member
npm run api member 123456

# Multiple members
npm run api member 123456,789012

获取车队信息

npm run api team 123456

获取会员生涯数据

npm run api member-career 123456

获取赛季回顾

# Current season recap
npm run api member-recap --member-id 123456

# Specific year and season
npm run api member-recap --member-id 123456 --year 2024 --season 1

查找车手

npm run api driver-lookup "Max Verstappen"

API 文档

npm run api documentation

🔧 开发环境设置

前置条件

• Node.js 24+
• npm
• 拥有有效订阅的 iRacing 账户

克隆并安装

git clone https://github.com/yourusername/iracing-data-mcp-server.git
cd iracing-data-mcp-server
npm install

🔐 身份验证与安全

API 密钥与密码

推荐：使用 API 密钥以增强安全性：

1. 生成 API 密钥：

   const crypto = require('crypto');
   const apiKey = crypto.createHash('sha256')
     .update(password + email)
     .digest('base64');
   

2. 在环境中设置：

   API_KEY=your_generated_api_key
   # Remove PASSWORD variable when using API_KEY
   

Cookie 管理

服务会自动管理身份验证 Cookie：

• 将 Cookie 存储在 COOKIE_JAR 指定的路径中
• 自动刷新过期会话
• 妥善处理身份验证错误

为赛车社区倾情打造 ❤️