lol-client-mcp Public

LoLクライアントMCP

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

概要

このプロジェクトは、リーグ・オブ・レジェンドのゲームクライアントのLive Client Data APIを使用して、リアルタイムのゲームデータにアクセスします。FastMCPフレームワークを活用して、様々なエンドポイントをツールとして公開します。

API 情報については、 https://developer.riotgames.com/docs/lolをご覧ください。

インストールと使用方法

前提条件

• Python 3.8以上
• uv - 高速で信頼性の高い Python パッケージ マネージャー
  • インストール: pip install uv
• リーグ・オブ・レジェンドクライアントがインストールされている

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

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

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

MCPサーバーの実行

直接実行するには:

クロードとの統合

Claude でこれを使用するには 2 つの方法があります。

1. クロードデスクトップ構成

claude_desktop_config.jsonファイルに次の内容を追加します。

重要: 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() : ライブリーグ・オブ・レジェンド クライアントデータ API には、/allgamedata エンドポイントから返されるデータのサブセットを返すエンドポイントがいくつかあります。このエンドポイントはライブクライアントデータ 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に帰属します。