iRacing MCP

iRacing MCP

iRacing MCP は、iRacing と Model Context Protocol（MCP）を統合する Python ベースのプロジェクトです。iRacing のデータを操作し、カスタムアプリケーションを構築するためのツールとリソースを提供します。

機能

• iRacing のプロフィール統計を取得します。
• iRating のチャートを取得します（任意のカテゴリーに対応）。
• 今後さらに追加予定です。

はじめに

前提条件

• uv - こちらからインストール
• レガシー認証が有効な iRacing アカウント（必須） - こちらで有効にできます：https://oauth.iracing.com/accountmanagement/security

使用方法

サーバーを単独で実行する

MCP サーバーを起動するには、次を実行します。

IRACING_USERNAME="your username" IRACING_PASSWORD="your-password" uvx iracing-mcp

VSCode でサーバーを実行する

これを settings.json の mcp.servers に追加します。

"iracing": {
    "command": "uvx",
    "args": [
        "iracing-mcp@latest"
    ],
    "env": {
        "IRACING_USERNAME": "[email protected]",
        "IRACING_PASSWORD": "your password"
    }
}

Claude Desktop で MCP サーバーを実行する

これを settings.json に追加します。

[
    "mcpServers": {
        "iracing": {
            "command": "uvx",
            "args": [
                "iracing-mcp@latest"
            ],
            "env": {
                "IRACING_USERNAME": "[email protected]",
                "IRACING_PASSWORD": "your-password"
            }
        }
    }
}

その他の MCP クライアントでサーバーを実行する

現在、MCP クライアントとして VS Code のみを使用しているため、その他の MCP クライアントの設定方法はわかりません。 各種 MCP サーバー（例：Cursor、Claude Desktop など）での設定方法について、PR をお寄せいただけると幸いです。

開発

1. リポジトリをクローンします。

   git clone https://github.com/musantro/iracing-mcp.git
   cd iracing-mcp
   

2. 依存関係を含む環境を作成します。

   uv sync
   

3. iRacing の認証情報に必要な環境変数を設定します。

   export IRACING_USERNAME="your_username"
   export IRACING_PASSWORD="your_password"
   

リントとフォーマット

コードのリントとフォーマットには、次のコマンドを使用します。

make

貢献

貢献を歓迎します！貢献するには、次の手順に従ってください。

1. リポジトリをフォークします。
2. 機能追加またはバグ修正用の新しいブランチを作成します。
3. ブランチをプッシュします。
4. プルリクエストを作成します。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。