Skip to main content

AI-powered League of Legends professional esports match predictor and summoner analysis tool. Predict outcomes for T1, Faker, Zeus, and other pro players with advanced statistical modeling.

Project description

League of Legends Mock Match Predictor

⚔️ AI-powered League of Legends mock match simulator and summoner comparison tool

This Model Context Protocol (MCP) server provides comprehensive League of Legends summoner analysis and mock match simulations based on historical performance data from the last 10 games.

Features

  • 🔍 Summoner Analysis: Get detailed statistics including KDA, damage dealt, and win rates
  • ⚔️ Mock Match Simulation: AI-powered 10-phase match progression simulation
  • 🌍 Multi-language Support: Available in 7 languages
  • 📊 Performance Comparison: Side-by-side summoner comparisons
  • 🎯 Match Prediction: Outcome prediction based on historical data

Supported Languages

  • English (EN/ENGLISH)
  • Korean (한국어)
  • Traditional Chinese (繁體中文)
  • Japanese (日本語)
  • Spanish (ESPAÑOL)
  • Bengali (বাংলা)
  • Punjabi (ਪੰਜਾਬੀ)

Installation

Prerequisites

  • Python 3.10 or higher
  • pip package manager

Setup

  1. Clone the repository:

    git clone https://github.com/onepersonunicorn/lolgpt.git
    cd lolgpt
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Set up environment variables (optional):

    export LOL_API_URL="https://1tier.xyz"
    export LOL_DEFAULT_LANGUAGE="EN"
    export LOL_API_TIMEOUT="30"
    
  4. Run the server:

    python main.py
    

Usage

Available Tools

The MCP server provides 6 different tools for various League of Legends simulation needs:

league_of_legends_summoner_vs_match

Main tool for comprehensive match simulation.

Parameters:

  • uidA (required): Riot ID of first summoner
  • tagA (required): Tag of first summoner
  • uidB (required): Riot ID of second summoner
  • tagB (required): Tag of second summoner
  • lang (optional): Language for simulation (default: "EN")

Example API call

await league_of_legends_summoner_vs_match(
    uidA="Hide on bush",
    tagA="KR1", 
    uidB="Zeus",
    tagB="KR1",
    lang="EN"
)

Example Usage

conversations

Sample Output

⚔️ **League of Legends Mock Match Simulation**
════════════════════════════════════════════

📊 Summoner A (PlayerOne#KR1) - Last 10 Games Statistics:
• Average Kills: 8.2
• Average Assists: 12.5
• Average Deaths: 4.1
• Average KDA: 5.05
• Average Damage Dealt: 28,450
• Win Rate: 70%

📊 Summoner B (PlayerTwo#NA1) - Last 10 Games Statistics:
• Average Kills: 6.8
• Average Assists: 9.2
• Average Deaths: 5.3
• Average KDA: 3.02
• Average Damage Dealt: 22,100
• Win Rate: 55%

🎯 Mock Match Simulation - Summoner's Rift:
════════════════════════════════════════════

Phase 1: Welcome to the Snowdown Showdown.
Phase 2: Thirty seconds until minions spawn.
Phase 3: Minions have spawned!
Phase 4: First blood! Zeus has been slain.
Phase 5: Hide on bush has slain an enemy!
Phase 6: Hide on bush has destroyed a turret.
Phase 7: Zeus Quadrakill!
Phase 8: Hide on bush is legendary!
Phase 9: Hide on bush has destroyed a inhibitor.
Phase 10: Hide on bush victory!

### Smithery Configuration

The server supports Smithery configuration via `smithery.yaml`:

startCommand:
  type: stdio
  configSchema:
    properties:
      debug:
        type: boolean
        default: false
      apiUrl:
        type: string
        default: "https://1tier.xyz"
      language:
        type: string
        default: "EN"
      timeout:
        type: number
        default: 30

API Integration

The server integrates with the 1tier.xyz API endpoint which provides:

  • Summoner Statistics: Last 10 games performance data
  • Match Simulation: AI-generated match progression
  • Multi-language Support: Localized simulation text
  • Real-time Data: Current summoner performance metrics

License

This project is licensed under the MIT License

Disclaimer

League of Legends mock match simulations are for entertainment purposes only. Results are based on historical performance data and do not guarantee actual match outcomes. League of Legends is a trademark of Riot Games, Inc.

Support

For issues and questions:

  • Create an issue on GitHub
  • Contact the development team

Acknowledgments

  • Riot Games for League of Legends
  • 1tier.xyz for providing the API infrastructure

Made with ❤️ for the League of Legends community

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netmind_lolgpt-1.0.0.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

netmind_lolGPT-1.0.0-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file netmind_lolgpt-1.0.0.tar.gz.

File metadata

  • Download URL: netmind_lolgpt-1.0.0.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.0

File hashes

Hashes for netmind_lolgpt-1.0.0.tar.gz
Algorithm Hash digest
SHA256 b784b22cf92350ca1093e7c363d7f69ba65def820c0821bb997558a5e8549d20
MD5 78f9b35f0f57883cba93a28cc0490cde
BLAKE2b-256 5019615aba43e395aed7a335a1163cc757588306255b60e5bd7b75eb132d0fe2

See more details on using hashes here.

File details

Details for the file netmind_lolGPT-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: netmind_lolGPT-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 6.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.0

File hashes

Hashes for netmind_lolGPT-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 712197220c813af151d05a3cfc4e732e8c7b603140b4c80f74ba1a110833301b
MD5 4ae48646124f7080cb860a094c75f24c
BLAKE2b-256 eeefa1bf680a4f1e9e487c03717217f21ccc9a4ffe911d2568cc87698513b2ba

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page