MCP Riot Server

MCP Riot サーバー

MCP-Riot は、コミュニティによって開発された Model Context Protocol (MCP) サーバーで、Riot Games API と連携し、League of Legends のデータを自然言語クエリを通じて AI アシスタントに提供します。

このプロジェクトにより、AI モデルはプレイヤー情報、ランク戦の統計、チャンピオンマスタリー、最近の試合のサマリーを取得できます。

免責事項: これはオープンソースプロジェクトであり、Riot Games とは提携しておらず、承認も受けていません。 League of Legends® は Riot Games, Inc. の登録商標です。

---

デモ

✨ 機能

🧾 プレイヤーサマリー

「Hide on bush の現在のランクとトップチャンピオンは？」

プレイヤーの以下を提供します:

• レベル
• ランク戦ソロのティア
• トップチャンピオンマスタリー
• 最近の試合履歴

🔝 トップチャンピオン

「彼が最も得意なチャンピオンは？」

マスタリーポイントに基づいて上位 N 体のチャンピオンを返します。

🎯 チャンピオンマスタリー

「このプレイヤーは Ahri をどれくらい上手く使える？」

特定のチャンピオンに関する詳細なチャンピオンマスタリーデータを返します。

🕹️ 最近の試合

「このサモナーの直近 3 試合を表示して」

使用チャンピオン、K/D/A、結果を含む最近の試合を一覧表示します。

📊 試合サマリー

「指定したマッチ ID のこの試合を要約して」

KDA、ダメージ、ワード、結果など、プレイヤーの試合統計を返します。

---

🚀 クイックスタート

1. クローンとインストール

git clone https://github.com/jifrozen0110/mcp-riot.git
cd mcp-riot

# Install dependencies (using uv or pip)
uv sync

2. API キーの取得と環境の設定

Riot API キーを含む .env ファイルを作成します:

RIOT_API_KEY=your_riot_api_key

キーは https://developer.riotgames.com/ から取得できます。

3. MCP クライアントの設定

このサーバーを MCP クライアント（例: Claude for Desktop）に登録します。

~/Library/Application Support/Claude/claude_desktop_config.json を編集します:

{
    "mcpServers": {
        "amadeus": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
                "run",
                "--env-file",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
                "riot.py"
            ]
        }
    }
}

/ABSOLUTE/PATH/TO/PARENT/FOLDER/ を、プロジェクトフォルダーへの実際のパスに置き換えてください。

自分の場合:

{
    "mcpServers": {
        "amadeus": {
            "command": "/Users/jifrozen/.local/bin/uv",
            "args": [
                "--directory",
                "/Users/jifrozen/mcp-riot/src/",
                "run",
                "--env-file",
                "/Users/jifrozen/mcp-riot/.env",
                "server.py"
            ]
        }
    }
}

---

🛠️ ツール

以下のツールが MCP クライアントに公開されます:

get_player_summary

レベル、ランク、トップチャンピオン、最近の試合を要約します。

get_top_champions_tool

マスタリーポイント順にトップチャンピオンを返します。

get_champion_mastery_tool

特定のチャンピオンのマスタリー詳細を返します。

get_recent_matches_tool

指定したサモナーの最近の試合を返します。

get_match_summary

指定したマッチ ID と puuid の試合パフォーマンス統計を返します。

---

📚 参考資料

• Model Context Protocol Python SDK
• Riot Games API Docs
• Data Dragon (static data)

---

📝 ライセンス

MIT License © 2025 jifrozen0110