Lol Client MCP

🚀 LoL クライアント MCP サーバー

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

🚀 クイックスタート

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

API の詳細については、https://developer.riotgames.com/docs/lol を参照してください。

✨ 主な機能

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

📦 インストール

前提条件

• 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 ウェブアプリに接続するには：

1. MCP サーバーを実行します：

python main.py

2. Claude ウェブインターフェイスでサーバー接続を設定します：
   • 会話を開始するときに下部の MCP 設定に入ります。
   • 'lol-client-mcp' を選択して接続します。

💻 使用例

基本的な使用法

# クローンする
git clone https://github.com/yourusername/lol-client-mcp.git
cd lol-client-mcp

# 必要なパッケージをインストールする
uv pip install httpx fastmcp

# MCP サーバーを実行する
python main.py

高度な使用法

# Claude Desktop との統合
{
    "mcpServers": {
        "lol-client-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

📚 ドキュメント

API ツールのリスト

ゲームデータ

• get_all_game_data(): League of Legends のリアルタイムクライアントデータ 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 に帰属します。