Lolgpt

🚀 League of Legends Mock Match Predictor

An AI-powered tool for League of Legends mock match simulations and summoner comparisons, offering in - depth analysis based on historical game data.

🚀 Quick Start

This Model Context Protocol (MCP) server offers comprehensive analysis of League of Legends summoners and simulates mock matches. It bases its operations on the historical performance data of the last 10 games.

✨ Features

• 🔍 Summoner Analysis: Obtain detailed statistics such as KDA, damage dealt, and win rates.
• ⚔️ Mock Match Simulation: An AI - driven simulation of a 10 - phase match progression.
• 🌍 Multi - language Support: Available in 7 different languages.
• 📊 Performance Comparison: Compare summoners side by side.
• 🎯 Match Prediction: Predict match outcomes using historical data.

📦 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 Examples

Available Tools

The MCP server provides 6 different tools to meet various League of Legends simulation requirements:

league_of_legends_summoner_vs_match

The main tool for comprehensive match simulation.

Parameters:

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

Basic Usage

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

Example Usage

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

📚 Documentation

API Integration

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

• Summoner Statistics: Performance data from the last 10 games.
• 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