MCP Riot

🚀 MCP 鋒riot サーバ

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

このプロジェクトにより、AIモデルはプレイヤー情報、ランク戦統計、英雄の習熟度、最近の試合概要を取得することができます。

免責事項: これはオープンソースプロジェクトであり、Riot Gamesによる関連付けやサポートはありません。League of Legends® は Riot Games, Inc. の登録商標です。

🚀 クイックスタート

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

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

# 依存関係のインストール（uv または pip を使用）
uv sync

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

.env ファイルを作成し、Riot APIキーを含めます。

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/user123/mcproto/mcp-riot/uv",
            "args": [
                "--directory",
                "/Users/user123/mcproto/mcp-riot",
                "run",
                "--env-file",
                "/Users/user123/mcproto/mcp-riot/.env",
                "python src/main.py"
            ]
        }
    }
}

Claudeアプリを再起動して変更を適用します。

✨ 主な機能

🧾 プレイヤー概要

"Hide on bush の現在のレベル、ランク、およびトップ英雄は何ですか？"

プレイヤーの以下の情報を提供します。

• レベル
• ランクソロレベル
• トップ英雄の習熟度
• 最近の試合履歴

🔝 トップ英雄

"彼が最も強い英雄はどれですか？"

習熟度ポイントに基づく上位N名の英雄を返します。

🎯 英雄習熟度

"彼のアリの強さはどの程度ですか？"

特定の英雄の詳細な習熟度データを返します。

🕹️ 最近の試合

"このサモナーの最近の3試合を表示してください"

最近の試合をリスト表示し、使用した英雄、K/D/A、結果を含みます。

📊 試合概要

"指定された試合IDの試合を要約してください"

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

💻 使用例

基本的な使用法

# プレイヤー情報のクエリ
curl -X POST "http://localhost:1234/_/query-player" -H "Content-Type: application/json" -d '{"player_name":"example_player"}'

# プレイヤーのトップ英雄の取得
curl -X POST "http://localhost:1234/_/get-top-champions" -H "Content-Type: application/json" -d '{"player_name":"example_player", "limit":3}'

# プレイヤーの試合履歴の取得
curl -X POST "http://localhost:1234/_/match-history" -H "Content-Type: application/json" -d '{"player_name":"example_player", "limit":5}'

🔧 技術詳細

提供されるツール

以下はサーバが公開するツールです。

query-player（プレイヤークエリ）

# 例：プレイヤー情報のクエリ
curl -X POST "http://localhost:1234/_/query-player" -H "Content-Type: application/json" -d '{"player_name":"example_player"}'

get-top-champions（トップ英雄の取得）

# 例：プレイヤーのトップ英雄の取得
curl -X POST "http://localhost:1234/_/get-top-champions" -H "Content-Type: application/json" -d '{"player_name":"example_player", "limit":3}'

match-history（試合履歴）

# 例：プレイヤーの試合履歴の取得
curl -X POST "http://localhost:1234/_/match-history" -H "Content-Type: application/json" -d '{"player_name":"example_player", "limit":5}'

📚 ドキュメント

• Riot Games API ドキュメント
• MCP プロトコルドキュメント
• プロジェクトソースコード

📄 ライセンス

MIT License

Copyright (c) 2024 jifrozen

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

⚠️ 重要提示

設定中に問題が発生した場合は、以下を確認してください。

• .env ファイルのパスが正しいか。
• APIキーが有効か。
• プロジェクトフォルダのアクセス権限が許可されているか。 問題が解決しない場合は、GitHub Issues で問題を報告できます。