convez.ai
MCP ServerIntegração & APIsIntermediário
rexlManu

League of Legends MCP Server

rexlManu/lol-mcp-server

Análise completa de jogadores LoL e geração de estratégias via MCP

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server com 30 ferramentas para análise de jogadores, revisão de partidas e geração de planos de treinamento em League of Legends via Riot API. Integra dados de contas, histórico de partidas, campeões, ligas e mais através de endpoints oficiais e scraping de fontes como Lolalytics.

Instalação

$npx convez-ai rexlManu/lol-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 1 semana
Versão
v1.1.1
Issues abertas
7
Contribuidores
1

Casos de uso

  • Análise detalhada de desempenho de jogadores e estatísticas ranqueadas
  • Revisão de partidas com timeline minuto-a-minuto e dados de campeões
  • Geração automática de planos de treinamento personalizados
  • Integração com coaches e ferramentas de análise esportiva

Veredito

MCP server bem estruturado e completo para o ecossistema League of Legends. Oferece cobertura ampla da Riot API com 30 ferramentas prontas, mas requer chave de API e conhecimento técnico para setup e customização adequada.

README

A tradução para o português deste README ainda está na fila.

League of Legends MCP Server

npm version CI License: MIT

MCP server exposing 30 tools for League of Legends player analysis, match review, and training-plan generation.

Installation

Via npm (recommended)

npm install -g lol-mcp-server

Via npx (no install)

npx lol-mcp-server

From source

git clone https://github.com/rexlManu/lol-mcp-server.git
cd lol-mcp-server
pnpm install
pnpm build

Setup

cp .env.example .env
# Edit .env and add your RIOT_API_KEY

Get your Riot API key at https://developer.riotgames.com/

MCP Client Configuration

Add to your MCP client config (Cursor, Claude Desktop, etc.):

{
  "mcpServers": {
    "league-of-legends": {
      "command": "lol-mcp-server",
      "env": {
        "RIOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if installed from source:

{
  "mcpServers": {
    "league-of-legends": {
      "command": "node",
      "args": ["/path/to/lol-mcp-server/dist/index.js"],
      "env": {
        "RIOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Stack

  • Runtime: Node.js 20+, TypeScript
  • Package manager: pnpm
  • MCP SDK: @modelcontextprotocol/sdk
  • Validation: zod
  • Scraping: cheerio (Lolalytics, League Wiki)
  • Static data: Data Dragon API
  • Testing: vitest
pnpm dev          # Run with tsx (hot reload)
pnpm build        # Compile to dist/
pnpm start        # Run compiled server
pnpm test         # Run tests
pnpm typecheck    # Type checking

MCP Client Configuration

Cursor / VS Code

{
  "mcpServers": {
    "league-of-legends": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "RIOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

opencode

{
  "mcpServers": {
    "league-of-legends": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "RIOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools (30 total)

Account & Profile (4)

ToolDescription
lol_get_accountGet Riot account info by Riot ID
lol_get_summonerGet summoner info (level, icon) by PUUID
lol_get_rankedGet ranked stats (tier, rank, LP, win rate)
lol_get_player_profileComplete player profile in one call

Match History (3)

ToolDescription
lol_get_match_historyGet recent match IDs (with filters)
lol_get_match_detailsGet detailed match data (batch supported)
lol_get_match_timelineGet minute-by-minute match timeline

Champion & Live (4)

ToolDescription
lol_get_champion_masteryGet champion mastery data
lol_get_live_gameCheck if player is in game
lol_get_champion_rotationGet free champion rotation
lol_get_featured_gamesGet featured games

League & Clash (7)

ToolDescription
lol_get_league_by_idGet league info by ID
lol_get_league_entriesGet league entries by summoner
lol_get_league_entries_expGet league entries (paginated, by queue/tier/division)
lol_get_league_topGet top players (challenger/grandmaster/master)
lol_get_clash_tournamentsGet active Clash tournaments
lol_get_clash_playerGet Clash player info
lol_get_clash_teamGet Clash team info

Challenges & Status (3)

ToolDescription
lol_get_challengesGet all challenge configurations
lol_get_player_challengesGet player challenge progress
lol_get_server_statusGet server status (maintenance/incidents)

Static Game Data (4)

ToolDescription
lol_get_all_championsList all champions (from Data Dragon)
lol_get_champ_infoDetailed champion info (Data Dragon + Wiki)
lol_get_all_itemsList all items with stats, cost, build path
lol_get_runesGet rune trees with keystones and descriptions

Lolalytics (1)

ToolDescription
lol_get_builds_for_championScrape Lolalytics for builds, runes, counters, meta

AI Analysis (4)

ToolDescription
lol_analyze_performanceAnalyze recent performance with recommendations
lol_analyze_championAnalyze performance on a specific champion
lol_get_improvement_tipsGet personalized improvement tips
lol_compare_playersCompare stats between two players

Region Support

User-facing regions: euw, eune, na, kr, br, lan, las, oce, ru, tr, jp, ph2, sg2, th2, tw2, vn2

Platform routing: euw1, eun1, na1, kr, jp1, br1, la1, la2, oc1, tr1, ru

Regional routing: europe, americas, asia, sea

Caching

Data TypeTTL
Live game / server status15-30s
Account / summoner / ranked60s
Champion mastery / match history2min
Lolalytics pages5min
Match details / timelines1h
Static data (champions/items/runes)24h

Error Handling

ErrorDescription
not found (404)Player/match not found
rate limited (429)Auto-retry with backoff
forbidden (403)Private data or restricted access
invalid key (401)Invalid Riot API key
scrape_layout_changedLolalytics page structure changed
network failureConnection/API error
invalid regionUnknown region code

Project Structure

src/
  index.ts              # Entry point, MCP server setup
  config.ts             # Environment config
  riot/
    client.ts           # Riot API HTTP client with rate limiting
    regions.ts          # Region routing maps
    types.ts            # Core Riot API types
    types-extra.ts      # Additional Riot API types
  cache/
    cache.ts            # TTL-based in-memory cache
  static-data/
    dataDragon.ts       # Data Dragon API client
    wikiScraper.ts      # League Wiki scraper (cheerio)
    types.ts            # Static data types
  lolalytics/
    scraper.ts          # Lolalytics page fetcher
    parser.ts           # HTML parser (cheerio)
    types.ts            # Lolalytics types
  tools/
    account.ts          # Account, summoner, ranked, profile, match tools
    champion.ts         # Mastery, live game, rotation, featured games
    league.ts           # League, clash, challenges, status
    staticData.ts       # Champions, items, runes
    lolalytics.ts       # Lolalytics builds
    analysis.ts         # Performance analysis, tips, comparison
  analysis/
    performance.ts      # Performance analysis engine
    championReview.ts   # Champion-specific analysis
    trainingPlan.ts     # Improvement tips generator
    compare.ts          # Player comparison
tests/
  regions.test.ts       # Region mapping tests
  cache.test.ts         # Cache tests
  lolalytics-parser.test.ts  # Parser tests
  analysis.test.ts      # Analysis engine tests

License

MIT

Ver o original no GitHub

Bom para

Relacionados