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

Clone the repository:

git clone https://github.com/onepersonunicorn/lolgpt.git
cd lolgpt

Install dependencies:
```
pip install -r requirements.txt
```

Set up environment variables (optional):

export LOL_API_URL="https://1tier.xyz"
export LOL_DEFAULT_LANGUAGE="EN"
export LOL_API_TIMEOUT="30"

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