LoL Client MCP

LoL Client MCP

League of Legends クライアントのデータにアクセスするための MCP（Model-Controller-Processor）サーバーです。このサーバーは、League of Legends Live Client Data API と通信してゲーム内データを取得するツールを提供します。

概要

このプロジェクトは、League of Legends ゲームクライアントの Live Client Data API を使用して、リアルタイムのゲームデータにアクセスします。FastMCP フレームワークを利用して、さまざまなエンドポイントをツールとして公開します。

API の情報は https://developer.riotgames.com/docs/lol にあります。

インストールと使用方法

前提条件

• Python 3.8 以降
• uv - 高速で信頼性の高い Python パッケージマネージャー
  • インストール：pip install uv
• League of Legends クライアントがインストールされていること

プロジェクトのセットアップ

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

git clone https://github.com/yourusername/lol-client-mcp.git
cd lol-client-mcp

2. uv を使用して必要なパッケージをインストールします。

uv pip install httpx fastmcp

MCP サーバーの起動

直接起動するには：

python main.py

Claude との連携

Claude で使用する方法は 2 つあります。

1. Claude Desktop の設定

以下を claude_desktop_config.json ファイルに追加します。

{
    "mcpServers": {
        "lol-client-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

重要：C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp を、プロジェクトの実際のパスに置き換えてください。

2. Web アプリケーションでの使用

MCP サーバーを Claude の Web アプリケーションに接続するには：

1. MCP サーバーを起動します。

   python main.py
   

2. Claude の Web インターフェースでサーバー接続を設定します。

   • 会話を開始するときに、画面下部の MCP 設定に移動します
   • 「lol-client-mcp」を選択して接続します

API ツール一覧

ゲームデータ

• get_all_game_data(): Live League of Legends Client Data API には、/allgamedata エンドポイントが返すデータの一部を返すエンドポイントが複数あります。このエンドポイントは Live Client Data API のテストに適していますが、このエンドポイントのすべてのデータが必要でない場合は、以下に記載されている、レスポンスの一部を返すエンドポイントを使用してください。
• get_game_stats(): ゲームに関する基本データを取得します。
• get_event_data(): ゲーム内で発生したイベントの一覧を取得します。

アクティブプレイヤーのデータ

• get_active_player(): アクティブプレイヤーに関するすべてのデータを取得します。
• get_active_player_name(): プレイヤー名を返します。
• get_active_player_abilities(): アクティブプレイヤーのアビリティを取得します。
• get_active_player_runes(): アクティブプレイヤーのルーン一覧を取得します。

プレイヤー一覧と個々のプレイヤーデータ

• get_player_list(): ゲーム内のチャンピオン一覧とそのステータスを取得します。
• get_player_scores(riot_id): プレイヤーの現在のスコア一覧を取得します。
• get_player_summoner_spells(riot_id): プレイヤーのサモナースペル一覧を取得します。
• get_player_main_runes(riot_id): 任意のプレイヤーの基本ルーンを取得します。
• get_player_items(riot_id): プレイヤーのアイテム一覧を取得します。

トラブルシューティング

• 接続エラー：League of Legends クライアントが起動しているか確認してください。
• タイムアウトエラー：ゲームが実際に開始していることを確認してください。この API はゲームロビーでは動作しません。

注意事項

• この API は、League of Legends クライアントが起動していて、ゲームが進行中の場合にのみ動作します。
• Riot Games API のポリシーを遵守して使用してください。

ライセンス

すべての権利は Riot Games に帰属します。