lol-mode-mcp

LoL「模式限定」資料的 MCP server + 查詢網站 —— 競技場(Arena)海克斯強化、競技場/ARAM 每英雄平衡、逐 patch 改動(競技場/一般對戰/ARAM Mayhem)。中英雙語,中文名稱一律採台服官方譯名(遊戲內字串,非機器翻譯)。

市面上的 LoL 工具幾乎都只做英雄/裝備,模式資料沒人整合,這個 server 補上這塊。

提供的能力

改動說明的中文採規則式翻譯(固定句型 + 台服術語對照表),沒把握的句子保留英文並標 🔤 —— 寧可給原文也不亂翻。

Related MCP server: LolByte MCP Server

查詢網站(給人看的)

https://lol-mode-mcp.onrender.com/ —— 四個分頁:海克斯圖鑑(稀有度篩選)、競技場平衡、Patch 改動(範圍/版本切換)、ARAM 平衡表(可排序)。支援中/EN 切換、深色/淺色主題、角色定位篩選(官方職業圖示)、中文名搜尋。

朋友使用方式(不用安裝任何東西)

1. 打開 Claude(桌面版/網頁版/手機版皆可)

2. 設定(Settings)→ 連接器(Connectors)→ 新增自訂連接器(Add custom connector)

3. 名稱隨意填(例如 LoL 模式資料),網址貼上:

   https://lol-mode-mcp.onrender.com/mcp

   💡 伺服器閒置 15 分鐘會休眠,第一個問題可能要等 30~60 秒喚醒,之後就是正常速度。

4. 儲存後開新對話,直接問:「灼燒煉金那個強化在做什麼」、「悟空的 ARAM 有被削嗎」

本機開發

需要 uv 與 Python 3.10+。

uv sync                                 # 安裝依賴
uv run pytest                           # 跑測試
uv run mcp dev src/lol_mode_mcp/server.py   # MCP Inspector 互動測試
uv run lol-mode-mcp                     # 直接啟動(stdio)

接上自己的 Claude Desktop(claude_desktop_config.json):

{
  "mcpServers": {
    "lol-mode-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "C:/Users/zhong/Desktop/LOL_MCP", "lol-mode-mcp"]
    }
  }
}

部署(Render 免費方案)

1. push 到 GitHub(NewJeans0722/lol-mode-mcp)

2. Render → New → Blueprint → 選這個 repo(設定都在 render.yaml)

3. 取得公開網址;之後每次 push 到 main 自動重新部署,朋友端不需任何動作

曾嘗試 FastMCP Cloud,但其免費方案的伺服器強制 Horizon 帳號驗證 (公開存取要付費),不符合「朋友貼網址就能用」的目標,故改用 Render。 repo 根目錄的 server.py 是為 FastMCP Cloud 準備的入口,保留備用。

環境變數:

安全性:本專案只提供公開遊戲資料、不碰任何秘密,目前不做驗證。

資料來源與致謝

• 競技場/Mayhem 強化與職業圖示:CommunityDragon —— 感謝社群維護的遊戲資料鏡像(patch 剛更新時可能有延遲)

• 平衡數值與逐 patch 改動:League of Legends Wiki(內容授權 CC BY-SA 4.0)

• 英雄/裝備/技能台服譯名:Riot Data Dragon

聯繫與協作聲明

• 📮 作者:GitHub @NewJeans0722;問題與建議請開 Issue

• 🤖 本專案與 Claude(Anthropic)協同開發:架構、程式碼與測試由 Claude Code 輔助完成,需求、範圍決策與驗收由作者主導

免責聲明

lol-mode-mcp 並非 Riot Games 官方出品,亦未獲得 Riot Games 認可或贊助。League of Legends 及 Riot Games 為 Riot Games, Inc. 之商標或註冊商標。

lol-mode-mcp isn't endorsed by Riot Games and doesn't reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games, and all associated properties are trademarks or registered trademarks of Riot Games, Inc.

License

MIT(程式碼);引用的資料內容依各來源授權(見上)。