iRacing 🐎

iRacing Data MCP Server 🏎️

iRacing のレーシングシミュレーションデータ API にシームレスにアクセスできる Node.js 製 Model Context Protocol（MCP）サーバーです。このプロジェクトは、スタンドアロンの CLI ツールと、AI アシスタント連携用の MCP サーバーの両方として機能します。

🌟 特長

🤖 MCP サーバー連携

• AI アシスタント対応：Claude、ChatGPT、その他の AI アシスタントとシームレスに連携できます
• リアルタイムのデータアクセス：iRacing の包括的なレーシングデータにリアルタイムでアクセスできます
• 自動認証：ログインとセッション管理を自動的に処理します
• 型安全な操作：Zod スキーマ検証に対応した TypeScript の完全サポート

📊 データアクセス

• メンバープロフィール：ライセンスやレーティングなど、ドライバーの詳細情報
• チーム情報：包括的なチームデータと統計
• キャリア統計：レーシングキャリアの完全な履歴と実績
• シーズンの概要：シーズンのパフォーマンスと進捗状況の詳細
• ドライバー検索：名前でドライバーを検索
• API ドキュメント：iRacing の API ドキュメントに組み込みでアクセス

🛠️ 2 種類のインターフェース

• MCP サーバー：AI アシスタントとの連携用
• CLI ツール：コマンドラインからの直接アクセスと自動化用

📖 使用方法

MCP サーバーとして使用

LLM クライアントの設定

Claude Desktop などの AI アシスタントでこの MCP サーバーを使用するには、次の設定を 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_JAR で指定されたパスに Cookie を保存します
• 期限切れのセッションを自動的に更新します
• 認証エラーを適切に処理します

レーシングコミュニティのために ❤️ を込めて作られました