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 的當前等級和排名以及頂級英雄是什麼？" 提供玩家的：

• 等級
• Ranked Solo 等級
• 頂級英雄掌握度
• 最近比賽歷史

🔝 頂級英雄

"他在哪些英雄上最強？" 返回基於掌握點數的前 N 名英雄。

🎯 英雄掌握度

"他用 Ahri 多強？" 返回特定英雄的詳細掌握度數據。

🕹️ 最近比賽

"展示這個召喚師的最近 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 提交問題。